@codeyam/codeyam-cli 0.1.0-staging.e38f7bd → 0.1.0-staging.e3d0ba6

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 (1565) 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 +37 -33
  5. package/analyzer-template/packages/ai/index.ts +21 -5
  6. package/analyzer-template/packages/ai/package.json +5 -5
  7. package/analyzer-template/packages/ai/src/lib/__mocks__/completionCall.ts +122 -0
  8. package/analyzer-template/packages/ai/src/lib/analyzeScope.ts +228 -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 +239 -13
  11. package/analyzer-template/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.ts +644 -0
  12. package/analyzer-template/packages/ai/src/lib/astScopes/methodSemantics.ts +316 -23
  13. package/analyzer-template/packages/ai/src/lib/astScopes/nodeToSource.ts +19 -0
  14. package/analyzer-template/packages/ai/src/lib/astScopes/paths.ts +11 -4
  15. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.ts +10 -17
  16. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.ts +18 -0
  17. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.ts +38 -1
  18. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.ts +181 -1
  19. package/analyzer-template/packages/ai/src/lib/astScopes/processExpression.ts +1619 -125
  20. package/analyzer-template/packages/ai/src/lib/astScopes/sharedPatterns.ts +28 -0
  21. package/analyzer-template/packages/ai/src/lib/astScopes/types.ts +324 -5
  22. package/analyzer-template/packages/ai/src/lib/checkAllAttributes.ts +29 -10
  23. package/analyzer-template/packages/ai/src/lib/completionCall.ts +247 -66
  24. package/analyzer-template/packages/ai/src/lib/dataStructure/ScopeDataStructure.ts +2810 -385
  25. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/ParentScopeManager.ts +10 -3
  26. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.ts +21 -4
  27. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.ts +976 -0
  28. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.ts +243 -77
  29. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.ts +16 -3
  30. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.ts +6 -4
  31. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.ts +87 -8
  32. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.ts +161 -19
  33. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.ts +70 -0
  34. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.ts +62 -0
  35. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.ts +163 -14
  36. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.ts +98 -0
  37. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.ts +179 -0
  38. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.ts +40 -30
  39. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.ts +441 -82
  40. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.ts +129 -0
  41. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.ts +35 -0
  42. package/analyzer-template/packages/ai/src/lib/dataStructureChunking.ts +183 -0
  43. package/analyzer-template/packages/ai/src/lib/deepEqual.ts +30 -0
  44. package/analyzer-template/packages/ai/src/lib/e2eDataTracking.ts +334 -0
  45. package/analyzer-template/packages/ai/src/lib/extractCriticalDataKeys.ts +120 -0
  46. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarioData.ts +74 -7
  47. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarios.ts +89 -112
  48. package/analyzer-template/packages/ai/src/lib/generateEntityDataStructure.ts +63 -2
  49. package/analyzer-template/packages/ai/src/lib/generateEntityScenarioData.ts +1495 -101
  50. package/analyzer-template/packages/ai/src/lib/generateEntityScenarios.ts +216 -109
  51. package/analyzer-template/packages/ai/src/lib/generateExecutionFlows.ts +677 -0
  52. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.ts +528 -0
  53. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionals.ts +2484 -0
  54. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.ts +239 -0
  55. package/analyzer-template/packages/ai/src/lib/getConditionalUsagesFromCode.ts +143 -31
  56. package/analyzer-template/packages/ai/src/lib/guessScenarioDataFromDescription.ts +8 -2
  57. package/analyzer-template/packages/ai/src/lib/isolateScopes.ts +328 -7
  58. package/analyzer-template/packages/ai/src/lib/mergeJsonTypeDefinitions.ts +5 -0
  59. package/analyzer-template/packages/ai/src/lib/mergeStatements.ts +111 -87
  60. package/analyzer-template/packages/ai/src/lib/promptGenerators/collapseNullableObjects.ts +118 -0
  61. package/analyzer-template/packages/ai/src/lib/promptGenerators/gatherAttributesMap.ts +17 -7
  62. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.ts +1 -1
  63. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.ts +32 -102
  64. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChunkPrompt.ts +82 -0
  65. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateCriticalKeysPrompt.ts +103 -0
  66. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.ts +110 -6
  67. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.ts +14 -53
  68. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.ts +58 -0
  69. package/analyzer-template/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.ts +28 -2
  70. package/analyzer-template/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.ts +391 -0
  71. package/analyzer-template/packages/ai/src/lib/resolvePathToControllable.ts +824 -0
  72. package/analyzer-template/packages/ai/src/lib/splitOutsideParentheses.ts +5 -1
  73. package/analyzer-template/packages/ai/src/lib/validateExecutionFlowPaths.ts +531 -0
  74. package/analyzer-template/packages/ai/src/lib/worker/SerializableDataStructure.ts +127 -3
  75. package/analyzer-template/packages/ai/src/lib/worker/analyzeScopeWorker.ts +121 -2
  76. package/analyzer-template/packages/analyze/index.ts +6 -1
  77. package/analyzer-template/packages/analyze/src/lib/FileAnalyzer.ts +79 -59
  78. package/analyzer-template/packages/analyze/src/lib/ProjectAnalyzer.ts +132 -33
  79. package/analyzer-template/packages/analyze/src/lib/analysisContext.ts +44 -4
  80. package/analyzer-template/packages/analyze/src/lib/asts/index.ts +7 -2
  81. package/analyzer-template/packages/analyze/src/lib/asts/nodes/getNodeType.ts +1 -0
  82. package/analyzer-template/packages/analyze/src/lib/asts/nodes/index.ts +1 -0
  83. package/analyzer-template/packages/analyze/src/lib/asts/nodes/isAsyncFunction.ts +67 -0
  84. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.ts +19 -0
  85. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.ts +19 -0
  86. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllExports.ts +11 -0
  87. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.ts +8 -0
  88. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.ts +49 -1
  89. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.ts +2 -1
  90. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.ts +592 -176
  91. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities.ts +67 -37
  92. package/analyzer-template/packages/analyze/src/lib/files/analyze/findOrCreateEntity.ts +25 -6
  93. package/analyzer-template/packages/analyze/src/lib/files/analyze/gatherEntityMap.ts +13 -14
  94. package/analyzer-template/packages/analyze/src/lib/files/analyze/trackEntityCircularDependencies.ts +21 -0
  95. package/analyzer-template/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.ts +115 -20
  96. package/analyzer-template/packages/analyze/src/lib/files/analyzeChange.ts +35 -15
  97. package/analyzer-template/packages/analyze/src/lib/files/analyzeEntity.ts +11 -7
  98. package/analyzer-template/packages/analyze/src/lib/files/analyzeInitial.ts +15 -12
  99. package/analyzer-template/packages/analyze/src/lib/files/analyzeNextRoute.ts +8 -3
  100. package/analyzer-template/packages/analyze/src/lib/files/analyzeRemixRoute.ts +4 -5
  101. package/analyzer-template/packages/analyze/src/lib/files/enums/steps.ts +1 -1
  102. package/analyzer-template/packages/analyze/src/lib/files/getImportedExports.ts +22 -13
  103. package/analyzer-template/packages/analyze/src/lib/files/scenarios/TransformationTracer.ts +1352 -0
  104. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.ts +313 -0
  105. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.ts +102 -0
  106. package/analyzer-template/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.ts +711 -78
  107. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.ts +1 -1
  108. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.ts +28 -62
  109. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateDataStructure.ts +822 -145
  110. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.ts +166 -0
  111. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarioData.ts +78 -83
  112. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarios.ts +4 -8
  113. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.ts +1882 -741
  114. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.ts +56 -11
  115. package/analyzer-template/packages/analyze/src/lib/files/scenarios/propagateArrayItemSchemas.ts +474 -0
  116. package/analyzer-template/packages/analyze/src/lib/files/setImportedExports.ts +2 -1
  117. package/analyzer-template/packages/analyze/src/lib/index.ts +1 -0
  118. package/analyzer-template/packages/analyze/src/lib/utils/getFileByPath.ts +19 -0
  119. package/analyzer-template/packages/aws/codebuild/index.ts +1 -0
  120. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts +11 -1
  121. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts.map +1 -1
  122. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js +29 -18
  123. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js.map +1 -1
  124. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts +2 -2
  125. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts.map +1 -1
  126. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js +2 -2
  127. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  128. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts +8 -18
  129. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts.map +1 -1
  130. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js +17 -61
  131. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  132. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.d.ts +15 -0
  133. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.d.ts.map +1 -0
  134. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.js +31 -0
  135. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.js.map +1 -0
  136. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.d.ts.map +1 -1
  137. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js +8 -1
  138. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js.map +1 -1
  139. package/analyzer-template/packages/aws/package.json +10 -10
  140. package/analyzer-template/packages/aws/s3/index.ts +1 -0
  141. package/analyzer-template/packages/aws/src/lib/codebuild/waitForBuild.ts +43 -19
  142. package/analyzer-template/packages/aws/src/lib/ecs/ecsDefineContainer.ts +3 -3
  143. package/analyzer-template/packages/aws/src/lib/ecs/ecsTaskFactory.ts +17 -69
  144. package/analyzer-template/packages/aws/src/lib/s3/checkS3ObjectExists.ts +47 -0
  145. package/analyzer-template/packages/aws/src/lib/s3/uploadFileToS3.ts +8 -1
  146. package/analyzer-template/packages/database/index.ts +1 -0
  147. package/analyzer-template/packages/database/package.json +4 -4
  148. package/analyzer-template/packages/database/src/lib/analysisBranchToDb.ts +1 -1
  149. package/analyzer-template/packages/database/src/lib/analysisToDb.ts +1 -1
  150. package/analyzer-template/packages/database/src/lib/branchToDb.ts +1 -1
  151. package/analyzer-template/packages/database/src/lib/commitBranchToDb.ts +1 -1
  152. package/analyzer-template/packages/database/src/lib/commitToDb.ts +1 -1
  153. package/analyzer-template/packages/database/src/lib/fileToDb.ts +1 -1
  154. package/analyzer-template/packages/database/src/lib/kysely/db.ts +26 -5
  155. package/analyzer-template/packages/database/src/lib/kysely/tableRelations.ts +2 -2
  156. package/analyzer-template/packages/database/src/lib/kysely/tables/commitsTable.ts +6 -0
  157. package/analyzer-template/packages/database/src/lib/kysely/tables/debugReportsTable.ts +36 -9
  158. package/analyzer-template/packages/database/src/lib/kysely/tables/editorScenariosTable.ts +164 -0
  159. package/analyzer-template/packages/database/src/lib/kysely/tables/labsRequestsTable.ts +52 -0
  160. package/analyzer-template/packages/database/src/lib/loadAnalyses.ts +58 -1
  161. package/analyzer-template/packages/database/src/lib/loadAnalysis.ts +38 -15
  162. package/analyzer-template/packages/database/src/lib/loadBranch.ts +16 -1
  163. package/analyzer-template/packages/database/src/lib/loadCommit.ts +11 -0
  164. package/analyzer-template/packages/database/src/lib/loadCommits.ts +58 -19
  165. package/analyzer-template/packages/database/src/lib/loadEntities.ts +26 -9
  166. package/analyzer-template/packages/database/src/lib/loadEntity.ts +19 -8
  167. package/analyzer-template/packages/database/src/lib/loadEntityBranches.ts +12 -0
  168. package/analyzer-template/packages/database/src/lib/loadReadyToBeCapturedAnalyses.ts +25 -5
  169. package/analyzer-template/packages/database/src/lib/projectToDb.ts +1 -1
  170. package/analyzer-template/packages/database/src/lib/saveFiles.ts +1 -1
  171. package/analyzer-template/packages/database/src/lib/scenarioToDb.ts +1 -1
  172. package/analyzer-template/packages/database/src/lib/updateCommitMetadata.ts +96 -152
  173. package/analyzer-template/packages/database/src/lib/updateFreshAnalysisStatus.ts +58 -42
  174. package/analyzer-template/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.ts +81 -65
  175. package/analyzer-template/packages/database/src/lib/userScenarioToDb.ts +1 -1
  176. package/analyzer-template/packages/generate/index.ts +3 -0
  177. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.ts +17 -1
  178. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.ts +221 -0
  179. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.ts +73 -0
  180. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts +42 -9
  181. package/analyzer-template/packages/generate/src/lib/deepMerge.ts +26 -1
  182. package/analyzer-template/packages/generate/src/lib/directExecutionScript.ts +17 -2
  183. package/analyzer-template/packages/generate/src/lib/getComponentScenarioPath.ts +8 -3
  184. package/analyzer-template/packages/generate/src/lib/scenarioComponentForServer.ts +114 -0
  185. package/analyzer-template/packages/github/dist/database/index.d.ts +1 -0
  186. package/analyzer-template/packages/github/dist/database/index.d.ts.map +1 -1
  187. package/analyzer-template/packages/github/dist/database/index.js +1 -0
  188. package/analyzer-template/packages/github/dist/database/index.js.map +1 -1
  189. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js +1 -1
  190. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js.map +1 -1
  191. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js +1 -1
  192. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js.map +1 -1
  193. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js +1 -1
  194. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js.map +1 -1
  195. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js +1 -1
  196. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js.map +1 -1
  197. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js +1 -1
  198. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js.map +1 -1
  199. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js +1 -1
  200. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js.map +1 -1
  201. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts +6 -2
  202. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts.map +1 -1
  203. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js +18 -3
  204. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js.map +1 -1
  205. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tableRelations.d.ts +2 -2
  206. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts +1 -11
  207. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts.map +1 -1
  208. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts +1 -0
  209. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts.map +1 -1
  210. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js +3 -0
  211. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  212. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts +30 -7
  213. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts.map +1 -1
  214. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.js +9 -3
  215. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  216. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.d.ts +29 -0
  217. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.d.ts.map +1 -0
  218. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.js +149 -0
  219. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.js.map +1 -0
  220. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts +1 -0
  221. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts.map +1 -1
  222. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts +23 -0
  223. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts.map +1 -0
  224. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  225. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  226. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts +7 -6
  227. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts.map +1 -1
  228. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts +2 -0
  229. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts.map +1 -1
  230. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js +45 -2
  231. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js.map +1 -1
  232. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.d.ts.map +1 -1
  233. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js +15 -1
  234. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js.map +1 -1
  235. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js +11 -1
  236. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js.map +1 -1
  237. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.d.ts.map +1 -1
  238. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js +7 -0
  239. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js.map +1 -1
  240. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts +3 -1
  241. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts.map +1 -1
  242. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js +45 -14
  243. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js.map +1 -1
  244. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts +3 -1
  245. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts.map +1 -1
  246. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js +23 -10
  247. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js.map +1 -1
  248. package/analyzer-template/packages/github/dist/database/src/lib/loadEntity.d.ts +4 -1
  249. package/analyzer-template/packages/github/dist/database/src/lib/loadEntity.d.ts.map +1 -1
  250. package/analyzer-template/packages/github/dist/database/src/lib/loadEntity.js +5 -5
  251. package/analyzer-template/packages/github/dist/database/src/lib/loadEntity.js.map +1 -1
  252. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.d.ts.map +1 -1
  253. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js +9 -0
  254. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js.map +1 -1
  255. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.d.ts.map +1 -1
  256. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js +20 -5
  257. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  258. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js +1 -1
  259. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js.map +1 -1
  260. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js +1 -1
  261. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js.map +1 -1
  262. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js +1 -1
  263. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js.map +1 -1
  264. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts +2 -2
  265. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts.map +1 -1
  266. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js +76 -89
  267. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js.map +1 -1
  268. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.d.ts.map +1 -1
  269. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.js +41 -30
  270. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.js.map +1 -1
  271. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.d.ts.map +1 -1
  272. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.js +68 -57
  273. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.js.map +1 -1
  274. package/analyzer-template/packages/github/dist/generate/index.d.ts +3 -0
  275. package/analyzer-template/packages/github/dist/generate/index.d.ts.map +1 -1
  276. package/analyzer-template/packages/github/dist/generate/index.js +3 -0
  277. package/analyzer-template/packages/github/dist/generate/index.js.map +1 -1
  278. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.d.ts.map +1 -1
  279. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  280. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  281. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts +9 -0
  282. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts.map +1 -0
  283. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +217 -0
  284. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  285. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts +20 -0
  286. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts.map +1 -0
  287. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  288. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  289. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.d.ts.map +1 -1
  290. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js +41 -9
  291. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js.map +1 -1
  292. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.d.ts.map +1 -1
  293. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js +27 -1
  294. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js.map +1 -1
  295. package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.d.ts.map +1 -1
  296. package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.js +10 -1
  297. package/analyzer-template/packages/github/dist/generate/src/lib/directExecutionScript.js.map +1 -1
  298. package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.d.ts.map +1 -1
  299. package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.js +7 -3
  300. package/analyzer-template/packages/github/dist/generate/src/lib/getComponentScenarioPath.js.map +1 -1
  301. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts +8 -0
  302. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts.map +1 -0
  303. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js +89 -0
  304. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  305. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.d.ts.map +1 -1
  306. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js +10 -0
  307. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js.map +1 -1
  308. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.d.ts.map +1 -1
  309. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js +3 -0
  310. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js.map +1 -1
  311. package/analyzer-template/packages/github/dist/types/index.d.ts +2 -2
  312. package/analyzer-template/packages/github/dist/types/index.d.ts.map +1 -1
  313. package/analyzer-template/packages/github/dist/types/index.js.map +1 -1
  314. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.d.ts +2 -0
  315. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.d.ts.map +1 -1
  316. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.js +2 -0
  317. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.js.map +1 -1
  318. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts +87 -13
  319. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts.map +1 -1
  320. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts +2 -0
  321. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts.map +1 -1
  322. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts +2 -0
  323. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts.map +1 -1
  324. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts +8 -0
  325. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  326. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts +21 -6
  327. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts.map +1 -1
  328. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts +199 -3
  329. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  330. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  331. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  332. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts +2 -0
  333. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  334. package/analyzer-template/packages/github/dist/utils/src/lib/applyUniversalMocks.d.ts.map +1 -1
  335. package/analyzer-template/packages/github/dist/utils/src/lib/applyUniversalMocks.js +26 -2
  336. package/analyzer-template/packages/github/dist/utils/src/lib/applyUniversalMocks.js.map +1 -1
  337. package/analyzer-template/packages/github/dist/utils/src/lib/lightweightEntityExtractor.d.ts.map +1 -1
  338. package/analyzer-template/packages/github/dist/utils/src/lib/lightweightEntityExtractor.js +25 -0
  339. package/analyzer-template/packages/github/dist/utils/src/lib/lightweightEntityExtractor.js.map +1 -1
  340. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts +9 -1
  341. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  342. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js +29 -3
  343. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js.map +1 -1
  344. package/analyzer-template/packages/github/package.json +2 -2
  345. package/analyzer-template/packages/github/src/lib/loadOrCreateCommit.ts +14 -0
  346. package/analyzer-template/packages/github/src/lib/syncPrimaryBranch.ts +2 -0
  347. package/analyzer-template/packages/process/index.ts +2 -0
  348. package/analyzer-template/packages/process/package.json +12 -0
  349. package/analyzer-template/packages/process/tsconfig.json +8 -0
  350. package/analyzer-template/packages/types/index.ts +5 -0
  351. package/analyzer-template/packages/types/src/enums/ProjectFramework.ts +2 -0
  352. package/analyzer-template/packages/types/src/types/Analysis.ts +104 -13
  353. package/analyzer-template/packages/types/src/types/Commit.ts +2 -0
  354. package/analyzer-template/packages/types/src/types/Entity.ts +2 -0
  355. package/analyzer-template/packages/types/src/types/ProjectMetadata.ts +8 -0
  356. package/analyzer-template/packages/types/src/types/Scenario.ts +21 -10
  357. package/analyzer-template/packages/types/src/types/ScenariosDataStructure.ts +228 -3
  358. package/analyzer-template/packages/types/src/types/ScopeAnalysis.ts +6 -1
  359. package/analyzer-template/packages/types/src/types/StatementInfo.ts +2 -0
  360. package/analyzer-template/packages/ui-components/package.json +5 -5
  361. package/analyzer-template/packages/ui-components/src/components/ScenarioDetailInteractiveView.tsx +23 -7
  362. package/analyzer-template/packages/utils/dist/types/index.d.ts +2 -2
  363. package/analyzer-template/packages/utils/dist/types/index.d.ts.map +1 -1
  364. package/analyzer-template/packages/utils/dist/types/index.js.map +1 -1
  365. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.d.ts +2 -0
  366. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.d.ts.map +1 -1
  367. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.js +2 -0
  368. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.js.map +1 -1
  369. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts +87 -13
  370. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts.map +1 -1
  371. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts +2 -0
  372. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts.map +1 -1
  373. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts +2 -0
  374. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts.map +1 -1
  375. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts +8 -0
  376. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  377. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts +21 -6
  378. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts.map +1 -1
  379. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts +199 -3
  380. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  381. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  382. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  383. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts +2 -0
  384. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  385. package/analyzer-template/packages/utils/dist/utils/src/lib/applyUniversalMocks.d.ts.map +1 -1
  386. package/analyzer-template/packages/utils/dist/utils/src/lib/applyUniversalMocks.js +26 -2
  387. package/analyzer-template/packages/utils/dist/utils/src/lib/applyUniversalMocks.js.map +1 -1
  388. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.d.ts +3 -1
  389. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.d.ts.map +1 -1
  390. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js +120 -4
  391. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  392. package/analyzer-template/packages/utils/dist/utils/src/lib/lightweightEntityExtractor.d.ts.map +1 -1
  393. package/analyzer-template/packages/utils/dist/utils/src/lib/lightweightEntityExtractor.js +25 -0
  394. package/analyzer-template/packages/utils/dist/utils/src/lib/lightweightEntityExtractor.js.map +1 -1
  395. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts +9 -1
  396. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  397. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js +29 -3
  398. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js.map +1 -1
  399. package/analyzer-template/packages/utils/src/lib/applyUniversalMocks.ts +28 -2
  400. package/analyzer-template/packages/utils/src/lib/fs/rsyncCopy.ts +148 -3
  401. package/analyzer-template/packages/utils/src/lib/lightweightEntityExtractor.ts +27 -0
  402. package/analyzer-template/packages/utils/src/lib/safeFileName.ts +48 -3
  403. package/analyzer-template/playwright/capture.ts +57 -26
  404. package/analyzer-template/playwright/captureFromUrl.ts +89 -82
  405. package/analyzer-template/playwright/captureStatic.ts +1 -1
  406. package/analyzer-template/playwright/getCodeYamInfo.ts +12 -7
  407. package/analyzer-template/playwright/takeElementScreenshot.ts +26 -11
  408. package/analyzer-template/playwright/takeScreenshot.ts +15 -9
  409. package/analyzer-template/playwright/waitForServer.ts +21 -6
  410. package/analyzer-template/project/TESTING.md +83 -0
  411. package/analyzer-template/project/analyzeBaselineCommit.ts +9 -0
  412. package/analyzer-template/project/analyzeBranchCommit.ts +4 -0
  413. package/analyzer-template/project/analyzeFileEntities.ts +30 -0
  414. package/analyzer-template/project/analyzeRegularCommit.ts +9 -0
  415. package/analyzer-template/project/captureLibraryFunctionDirect.ts +29 -26
  416. package/analyzer-template/project/constructMockCode.ts +1459 -178
  417. package/analyzer-template/project/controller/startController.ts +16 -1
  418. package/analyzer-template/project/createEntitiesAndSortFiles.ts +83 -0
  419. package/analyzer-template/project/executeLibraryFunctionDirect.ts +7 -3
  420. package/analyzer-template/project/loadReadyToBeCaptured.ts +82 -42
  421. package/analyzer-template/project/mocks/analyzeFileMock.ts +8 -7
  422. package/analyzer-template/project/orchestrateCapture/AwsCaptureTaskRunner.ts +12 -4
  423. package/analyzer-template/project/orchestrateCapture/KyselyAnalysisLoader.ts +13 -9
  424. package/analyzer-template/project/orchestrateCapture/SequentialCaptureTaskRunner.ts +93 -42
  425. package/analyzer-template/project/orchestrateCapture/taskRunner.ts +4 -2
  426. package/analyzer-template/project/orchestrateCapture.ts +92 -13
  427. package/analyzer-template/project/reconcileMockDataKeys.ts +251 -3
  428. package/analyzer-template/project/runAnalysis.ts +11 -0
  429. package/analyzer-template/project/runMultiScenarioServer.ts +37 -13
  430. package/analyzer-template/project/serverOnlyModules.ts +413 -0
  431. package/analyzer-template/project/start.ts +75 -19
  432. package/analyzer-template/project/startScenarioCapture.ts +88 -41
  433. package/analyzer-template/project/writeClientLogRoute.ts +125 -0
  434. package/analyzer-template/project/writeMockDataTsx.ts +483 -73
  435. package/analyzer-template/project/writeScenarioClientWrapper.ts +21 -0
  436. package/analyzer-template/project/writeScenarioComponents.ts +1538 -226
  437. package/analyzer-template/project/writeScenarioFiles.ts +26 -0
  438. package/analyzer-template/project/writeSimpleRoot.ts +56 -22
  439. package/analyzer-template/project/writeUniversalMocks.ts +32 -11
  440. package/analyzer-template/scripts/comboWorkerLoop.cjs +99 -50
  441. package/analyzer-template/scripts/defaultCmd.sh +9 -0
  442. package/analyzer-template/tsconfig.json +14 -1
  443. package/background/src/lib/local/createLocalAnalyzer.js +2 -30
  444. package/background/src/lib/local/createLocalAnalyzer.js.map +1 -1
  445. package/background/src/lib/local/execAsync.js +1 -1
  446. package/background/src/lib/local/execAsync.js.map +1 -1
  447. package/background/src/lib/virtualized/common/execAsync.js +1 -1
  448. package/background/src/lib/virtualized/common/execAsync.js.map +1 -1
  449. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js +7 -1
  450. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js.map +1 -1
  451. package/background/src/lib/virtualized/project/analyzeBranchCommit.js +2 -1
  452. package/background/src/lib/virtualized/project/analyzeBranchCommit.js.map +1 -1
  453. package/background/src/lib/virtualized/project/analyzeFileEntities.js +24 -1
  454. package/background/src/lib/virtualized/project/analyzeFileEntities.js.map +1 -1
  455. package/background/src/lib/virtualized/project/analyzeRegularCommit.js +7 -1
  456. package/background/src/lib/virtualized/project/analyzeRegularCommit.js.map +1 -1
  457. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js +3 -3
  458. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js.map +1 -1
  459. package/background/src/lib/virtualized/project/constructMockCode.js +1288 -133
  460. package/background/src/lib/virtualized/project/constructMockCode.js.map +1 -1
  461. package/background/src/lib/virtualized/project/controller/startController.js +11 -1
  462. package/background/src/lib/virtualized/project/controller/startController.js.map +1 -1
  463. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js +73 -1
  464. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js.map +1 -1
  465. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js +6 -3
  466. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js.map +1 -1
  467. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js +34 -9
  468. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js.map +1 -1
  469. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js +7 -7
  470. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js.map +1 -1
  471. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js +2 -2
  472. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js.map +1 -1
  473. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js +12 -6
  474. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js.map +1 -1
  475. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js +73 -36
  476. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js.map +1 -1
  477. package/background/src/lib/virtualized/project/orchestrateCapture.js +76 -14
  478. package/background/src/lib/virtualized/project/orchestrateCapture.js.map +1 -1
  479. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js +211 -3
  480. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js.map +1 -1
  481. package/background/src/lib/virtualized/project/runAnalysis.js +9 -0
  482. package/background/src/lib/virtualized/project/runAnalysis.js.map +1 -1
  483. package/background/src/lib/virtualized/project/runMultiScenarioServer.js +34 -12
  484. package/background/src/lib/virtualized/project/runMultiScenarioServer.js.map +1 -1
  485. package/background/src/lib/virtualized/project/serverOnlyModules.js +338 -0
  486. package/background/src/lib/virtualized/project/serverOnlyModules.js.map +1 -0
  487. package/background/src/lib/virtualized/project/start.js +64 -19
  488. package/background/src/lib/virtualized/project/start.js.map +1 -1
  489. package/background/src/lib/virtualized/project/startScenarioCapture.js +66 -31
  490. package/background/src/lib/virtualized/project/startScenarioCapture.js.map +1 -1
  491. package/background/src/lib/virtualized/project/writeClientLogRoute.js +110 -0
  492. package/background/src/lib/virtualized/project/writeClientLogRoute.js.map +1 -0
  493. package/background/src/lib/virtualized/project/writeMockDataTsx.js +416 -62
  494. package/background/src/lib/virtualized/project/writeMockDataTsx.js.map +1 -1
  495. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js +15 -0
  496. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js.map +1 -0
  497. package/background/src/lib/virtualized/project/writeScenarioComponents.js +1134 -153
  498. package/background/src/lib/virtualized/project/writeScenarioComponents.js.map +1 -1
  499. package/background/src/lib/virtualized/project/writeScenarioFiles.js +19 -0
  500. package/background/src/lib/virtualized/project/writeScenarioFiles.js.map +1 -1
  501. package/background/src/lib/virtualized/project/writeSimpleRoot.js +57 -20
  502. package/background/src/lib/virtualized/project/writeSimpleRoot.js.map +1 -1
  503. package/background/src/lib/virtualized/project/writeUniversalMocks.js +27 -12
  504. package/background/src/lib/virtualized/project/writeUniversalMocks.js.map +1 -1
  505. package/codeyam-cli/scripts/apply-setup.js +386 -9
  506. package/codeyam-cli/scripts/apply-setup.js.map +1 -1
  507. package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js +196 -0
  508. package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js.map +1 -0
  509. package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js +114 -0
  510. package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js.map +1 -0
  511. package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js +149 -0
  512. package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js.map +1 -0
  513. package/codeyam-cli/src/cli.js +63 -22
  514. package/codeyam-cli/src/cli.js.map +1 -1
  515. package/codeyam-cli/src/codeyam-cli.js +18 -2
  516. package/codeyam-cli/src/codeyam-cli.js.map +1 -1
  517. package/codeyam-cli/src/commands/__tests__/editor.analyzeImportsArgs.test.js +47 -0
  518. package/codeyam-cli/src/commands/__tests__/editor.analyzeImportsArgs.test.js.map +1 -0
  519. package/codeyam-cli/src/commands/__tests__/editor.auditNoAutoAnalysis.test.js +71 -0
  520. package/codeyam-cli/src/commands/__tests__/editor.auditNoAutoAnalysis.test.js.map +1 -0
  521. package/codeyam-cli/src/commands/__tests__/editor.designSystem.test.js +30 -0
  522. package/codeyam-cli/src/commands/__tests__/editor.designSystem.test.js.map +1 -0
  523. package/codeyam-cli/src/commands/__tests__/editor.isolateArgs.test.js +51 -0
  524. package/codeyam-cli/src/commands/__tests__/editor.isolateArgs.test.js.map +1 -0
  525. package/codeyam-cli/src/commands/__tests__/editor.statePersistence.test.js +55 -0
  526. package/codeyam-cli/src/commands/__tests__/editor.statePersistence.test.js.map +1 -0
  527. package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js +56 -0
  528. package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js.map +1 -0
  529. package/codeyam-cli/src/commands/__tests__/init.gitignore.test.js +101 -47
  530. package/codeyam-cli/src/commands/__tests__/init.gitignore.test.js.map +1 -1
  531. package/codeyam-cli/src/commands/analyze.js +22 -10
  532. package/codeyam-cli/src/commands/analyze.js.map +1 -1
  533. package/codeyam-cli/src/commands/baseline.js +176 -0
  534. package/codeyam-cli/src/commands/baseline.js.map +1 -0
  535. package/codeyam-cli/src/commands/debug.js +44 -18
  536. package/codeyam-cli/src/commands/debug.js.map +1 -1
  537. package/codeyam-cli/src/commands/default.js +43 -35
  538. package/codeyam-cli/src/commands/default.js.map +1 -1
  539. package/codeyam-cli/src/commands/editor.js +6180 -0
  540. package/codeyam-cli/src/commands/editor.js.map +1 -0
  541. package/codeyam-cli/src/commands/editorAnalyzeImportsArgs.js +23 -0
  542. package/codeyam-cli/src/commands/editorAnalyzeImportsArgs.js.map +1 -0
  543. package/codeyam-cli/src/commands/editorIsolateArgs.js +25 -0
  544. package/codeyam-cli/src/commands/editorIsolateArgs.js.map +1 -0
  545. package/codeyam-cli/src/commands/init.js +148 -292
  546. package/codeyam-cli/src/commands/init.js.map +1 -1
  547. package/codeyam-cli/src/commands/memory.js +278 -0
  548. package/codeyam-cli/src/commands/memory.js.map +1 -0
  549. package/codeyam-cli/src/commands/recapture.js +228 -0
  550. package/codeyam-cli/src/commands/recapture.js.map +1 -0
  551. package/codeyam-cli/src/commands/report.js +72 -24
  552. package/codeyam-cli/src/commands/report.js.map +1 -1
  553. package/codeyam-cli/src/commands/setup-sandbox.js +2 -0
  554. package/codeyam-cli/src/commands/setup-sandbox.js.map +1 -1
  555. package/codeyam-cli/src/commands/setup-simulations.js +284 -0
  556. package/codeyam-cli/src/commands/setup-simulations.js.map +1 -0
  557. package/codeyam-cli/src/commands/start.js +8 -12
  558. package/codeyam-cli/src/commands/start.js.map +1 -1
  559. package/codeyam-cli/src/commands/status.js +23 -1
  560. package/codeyam-cli/src/commands/status.js.map +1 -1
  561. package/codeyam-cli/src/commands/telemetry.js +37 -0
  562. package/codeyam-cli/src/commands/telemetry.js.map +1 -0
  563. package/codeyam-cli/src/commands/test-startup.js +3 -1
  564. package/codeyam-cli/src/commands/test-startup.js.map +1 -1
  565. package/codeyam-cli/src/commands/verify.js +14 -2
  566. package/codeyam-cli/src/commands/verify.js.map +1 -1
  567. package/codeyam-cli/src/commands/wipe.js +108 -0
  568. package/codeyam-cli/src/commands/wipe.js.map +1 -0
  569. package/codeyam-cli/src/data/designSystems.js +27 -0
  570. package/codeyam-cli/src/data/designSystems.js.map +1 -0
  571. package/codeyam-cli/src/data/techStacks.js +77 -0
  572. package/codeyam-cli/src/data/techStacks.js.map +1 -0
  573. package/codeyam-cli/src/utils/__tests__/analyzerFinalization.test.js +173 -0
  574. package/codeyam-cli/src/utils/__tests__/analyzerFinalization.test.js.map +1 -0
  575. package/codeyam-cli/src/utils/__tests__/backgroundServer.test.js +46 -0
  576. package/codeyam-cli/src/utils/__tests__/backgroundServer.test.js.map +1 -0
  577. package/codeyam-cli/src/utils/__tests__/devServerState.test.js +134 -0
  578. package/codeyam-cli/src/utils/__tests__/devServerState.test.js.map +1 -0
  579. package/codeyam-cli/src/utils/__tests__/editorApi.test.js +181 -0
  580. package/codeyam-cli/src/utils/__tests__/editorApi.test.js.map +1 -0
  581. package/codeyam-cli/src/utils/__tests__/editorAudit.test.js +4160 -0
  582. package/codeyam-cli/src/utils/__tests__/editorAudit.test.js.map +1 -0
  583. package/codeyam-cli/src/utils/__tests__/editorBroadcastViewport.test.js +76 -0
  584. package/codeyam-cli/src/utils/__tests__/editorBroadcastViewport.test.js.map +1 -0
  585. package/codeyam-cli/src/utils/__tests__/editorCapture.test.js +93 -0
  586. package/codeyam-cli/src/utils/__tests__/editorCapture.test.js.map +1 -0
  587. package/codeyam-cli/src/utils/__tests__/editorCaptureScenarioSeeding.test.js +137 -0
  588. package/codeyam-cli/src/utils/__tests__/editorCaptureScenarioSeeding.test.js.map +1 -0
  589. package/codeyam-cli/src/utils/__tests__/editorDeleteScenario.test.js +100 -0
  590. package/codeyam-cli/src/utils/__tests__/editorDeleteScenario.test.js.map +1 -0
  591. package/codeyam-cli/src/utils/__tests__/editorDevServer.test.js +304 -0
  592. package/codeyam-cli/src/utils/__tests__/editorDevServer.test.js.map +1 -0
  593. package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js +194 -0
  594. package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js.map +1 -0
  595. package/codeyam-cli/src/utils/__tests__/editorEntityHelpers.test.js +381 -0
  596. package/codeyam-cli/src/utils/__tests__/editorEntityHelpers.test.js.map +1 -0
  597. package/codeyam-cli/src/utils/__tests__/editorGuardMiddleware.test.js +67 -0
  598. package/codeyam-cli/src/utils/__tests__/editorGuardMiddleware.test.js.map +1 -0
  599. package/codeyam-cli/src/utils/__tests__/editorImageVerifier.test.js +294 -0
  600. package/codeyam-cli/src/utils/__tests__/editorImageVerifier.test.js.map +1 -0
  601. package/codeyam-cli/src/utils/__tests__/editorJournal.test.js +542 -0
  602. package/codeyam-cli/src/utils/__tests__/editorJournal.test.js.map +1 -0
  603. package/codeyam-cli/src/utils/__tests__/editorLoaderHelpers.test.js +594 -0
  604. package/codeyam-cli/src/utils/__tests__/editorLoaderHelpers.test.js.map +1 -0
  605. package/codeyam-cli/src/utils/__tests__/editorMigration.test.js +435 -0
  606. package/codeyam-cli/src/utils/__tests__/editorMigration.test.js.map +1 -0
  607. package/codeyam-cli/src/utils/__tests__/editorMockState.test.js +270 -0
  608. package/codeyam-cli/src/utils/__tests__/editorMockState.test.js.map +1 -0
  609. package/codeyam-cli/src/utils/__tests__/editorPreloadHelpers.test.js +217 -0
  610. package/codeyam-cli/src/utils/__tests__/editorPreloadHelpers.test.js.map +1 -0
  611. package/codeyam-cli/src/utils/__tests__/editorPreview.test.js +361 -0
  612. package/codeyam-cli/src/utils/__tests__/editorPreview.test.js.map +1 -0
  613. package/codeyam-cli/src/utils/__tests__/editorProxySession.test.js +153 -0
  614. package/codeyam-cli/src/utils/__tests__/editorProxySession.test.js.map +1 -0
  615. package/codeyam-cli/src/utils/__tests__/editorRoadmap.test.js +398 -0
  616. package/codeyam-cli/src/utils/__tests__/editorRoadmap.test.js.map +1 -0
  617. package/codeyam-cli/src/utils/__tests__/editorScenarioLookup.test.js +139 -0
  618. package/codeyam-cli/src/utils/__tests__/editorScenarioLookup.test.js.map +1 -0
  619. package/codeyam-cli/src/utils/__tests__/editorScenarioSwitch.test.js +411 -0
  620. package/codeyam-cli/src/utils/__tests__/editorScenarioSwitch.test.js.map +1 -0
  621. package/codeyam-cli/src/utils/__tests__/editorScenarios.test.js +1768 -0
  622. package/codeyam-cli/src/utils/__tests__/editorScenarios.test.js.map +1 -0
  623. package/codeyam-cli/src/utils/__tests__/editorSeedAdapter.test.js +413 -0
  624. package/codeyam-cli/src/utils/__tests__/editorSeedAdapter.test.js.map +1 -0
  625. package/codeyam-cli/src/utils/__tests__/editorSeedAdapterPrismaValidation.test.js +143 -0
  626. package/codeyam-cli/src/utils/__tests__/editorSeedAdapterPrismaValidation.test.js.map +1 -0
  627. package/codeyam-cli/src/utils/__tests__/editorSessionFilter.test.js +66 -0
  628. package/codeyam-cli/src/utils/__tests__/editorSessionFilter.test.js.map +1 -0
  629. package/codeyam-cli/src/utils/__tests__/editorShouldRevalidate.test.js +53 -0
  630. package/codeyam-cli/src/utils/__tests__/editorShouldRevalidate.test.js.map +1 -0
  631. package/codeyam-cli/src/utils/__tests__/entityChangeStatus.test.js +2121 -0
  632. package/codeyam-cli/src/utils/__tests__/entityChangeStatus.test.js.map +1 -0
  633. package/codeyam-cli/src/utils/__tests__/git.editor.test.js +134 -0
  634. package/codeyam-cli/src/utils/__tests__/git.editor.test.js.map +1 -0
  635. package/codeyam-cli/src/utils/__tests__/glossaryAdd.test.js +177 -0
  636. package/codeyam-cli/src/utils/__tests__/glossaryAdd.test.js.map +1 -0
  637. package/codeyam-cli/src/utils/__tests__/journalCaptureStabilization.test.js +122 -0
  638. package/codeyam-cli/src/utils/__tests__/journalCaptureStabilization.test.js.map +1 -0
  639. package/codeyam-cli/src/utils/__tests__/manualEntityAnalysis.test.js +302 -0
  640. package/codeyam-cli/src/utils/__tests__/manualEntityAnalysis.test.js.map +1 -0
  641. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js +185 -0
  642. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js.map +1 -0
  643. package/codeyam-cli/src/utils/__tests__/parseRegisterArg.test.js +129 -0
  644. package/codeyam-cli/src/utils/__tests__/parseRegisterArg.test.js.map +1 -0
  645. package/codeyam-cli/src/utils/__tests__/pathIgnoring.test.js +9 -0
  646. package/codeyam-cli/src/utils/__tests__/pathIgnoring.test.js.map +1 -1
  647. package/codeyam-cli/src/utils/__tests__/project.test.js +65 -0
  648. package/codeyam-cli/src/utils/__tests__/project.test.js.map +1 -0
  649. package/codeyam-cli/src/utils/__tests__/registerScenarioResult.test.js +127 -0
  650. package/codeyam-cli/src/utils/__tests__/registerScenarioResult.test.js.map +1 -0
  651. package/codeyam-cli/src/utils/__tests__/routePatternMatching.test.js +118 -0
  652. package/codeyam-cli/src/utils/__tests__/routePatternMatching.test.js.map +1 -0
  653. package/codeyam-cli/src/utils/__tests__/scenarioCoverage.test.js +284 -0
  654. package/codeyam-cli/src/utils/__tests__/scenarioCoverage.test.js.map +1 -0
  655. package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js +121 -0
  656. package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js.map +1 -0
  657. package/codeyam-cli/src/utils/__tests__/scenariosManifest.test.js +672 -0
  658. package/codeyam-cli/src/utils/__tests__/scenariosManifest.test.js.map +1 -0
  659. package/codeyam-cli/src/utils/__tests__/screenshotHash.test.js +84 -0
  660. package/codeyam-cli/src/utils/__tests__/screenshotHash.test.js.map +1 -0
  661. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js +81 -0
  662. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js.map +1 -0
  663. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js +175 -82
  664. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js.map +1 -1
  665. package/codeyam-cli/src/utils/__tests__/telemetry.test.js +159 -0
  666. package/codeyam-cli/src/utils/__tests__/telemetry.test.js.map +1 -0
  667. package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js +51 -0
  668. package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js.map +1 -0
  669. package/codeyam-cli/src/utils/__tests__/testRunner.test.js +216 -0
  670. package/codeyam-cli/src/utils/__tests__/testRunner.test.js.map +1 -0
  671. package/codeyam-cli/src/utils/__tests__/webappDetection.test.js +148 -0
  672. package/codeyam-cli/src/utils/__tests__/webappDetection.test.js.map +1 -0
  673. package/codeyam-cli/src/utils/analysisRunner.js +67 -22
  674. package/codeyam-cli/src/utils/analysisRunner.js.map +1 -1
  675. package/codeyam-cli/src/utils/analyzer.js +26 -0
  676. package/codeyam-cli/src/utils/analyzer.js.map +1 -1
  677. package/codeyam-cli/src/utils/analyzerFinalization.js +100 -0
  678. package/codeyam-cli/src/utils/analyzerFinalization.js.map +1 -0
  679. package/codeyam-cli/src/utils/backgroundServer.js +205 -32
  680. package/codeyam-cli/src/utils/backgroundServer.js.map +1 -1
  681. package/codeyam-cli/src/utils/buildFlags.js +4 -0
  682. package/codeyam-cli/src/utils/buildFlags.js.map +1 -0
  683. package/codeyam-cli/src/utils/database.js +128 -7
  684. package/codeyam-cli/src/utils/database.js.map +1 -1
  685. package/codeyam-cli/src/utils/designSystemShowcase.js +810 -0
  686. package/codeyam-cli/src/utils/designSystemShowcase.js.map +1 -0
  687. package/codeyam-cli/src/utils/devModeEvents.js +40 -0
  688. package/codeyam-cli/src/utils/devModeEvents.js.map +1 -0
  689. package/codeyam-cli/src/utils/devServerState.js +71 -0
  690. package/codeyam-cli/src/utils/devServerState.js.map +1 -0
  691. package/codeyam-cli/src/utils/editorApi.js +95 -0
  692. package/codeyam-cli/src/utils/editorApi.js.map +1 -0
  693. package/codeyam-cli/src/utils/editorAudit.js +849 -0
  694. package/codeyam-cli/src/utils/editorAudit.js.map +1 -0
  695. package/codeyam-cli/src/utils/editorBroadcastViewport.js +26 -0
  696. package/codeyam-cli/src/utils/editorBroadcastViewport.js.map +1 -0
  697. package/codeyam-cli/src/utils/editorCapture.js +102 -0
  698. package/codeyam-cli/src/utils/editorCapture.js.map +1 -0
  699. package/codeyam-cli/src/utils/editorDeleteScenario.js +67 -0
  700. package/codeyam-cli/src/utils/editorDeleteScenario.js.map +1 -0
  701. package/codeyam-cli/src/utils/editorDevServer.js +197 -0
  702. package/codeyam-cli/src/utils/editorDevServer.js.map +1 -0
  703. package/codeyam-cli/src/utils/editorEntityChangeStatus.js +50 -0
  704. package/codeyam-cli/src/utils/editorEntityChangeStatus.js.map +1 -0
  705. package/codeyam-cli/src/utils/editorEntityHelpers.js +144 -0
  706. package/codeyam-cli/src/utils/editorEntityHelpers.js.map +1 -0
  707. package/codeyam-cli/src/utils/editorGuard.js +36 -0
  708. package/codeyam-cli/src/utils/editorGuard.js.map +1 -0
  709. package/codeyam-cli/src/utils/editorImageVerifier.js +155 -0
  710. package/codeyam-cli/src/utils/editorImageVerifier.js.map +1 -0
  711. package/codeyam-cli/src/utils/editorJournal.js +225 -0
  712. package/codeyam-cli/src/utils/editorJournal.js.map +1 -0
  713. package/codeyam-cli/src/utils/editorLoaderHelpers.js +152 -0
  714. package/codeyam-cli/src/utils/editorLoaderHelpers.js.map +1 -0
  715. package/codeyam-cli/src/utils/editorMigration.js +224 -0
  716. package/codeyam-cli/src/utils/editorMigration.js.map +1 -0
  717. package/codeyam-cli/src/utils/editorMockState.js +248 -0
  718. package/codeyam-cli/src/utils/editorMockState.js.map +1 -0
  719. package/codeyam-cli/src/utils/editorPreloadHelpers.js +135 -0
  720. package/codeyam-cli/src/utils/editorPreloadHelpers.js.map +1 -0
  721. package/codeyam-cli/src/utils/editorPreview.js +139 -0
  722. package/codeyam-cli/src/utils/editorPreview.js.map +1 -0
  723. package/codeyam-cli/src/utils/editorRecapture.js +109 -0
  724. package/codeyam-cli/src/utils/editorRecapture.js.map +1 -0
  725. package/codeyam-cli/src/utils/editorRoadmap.js +301 -0
  726. package/codeyam-cli/src/utils/editorRoadmap.js.map +1 -0
  727. package/codeyam-cli/src/utils/editorScenarioSwitch.js +149 -0
  728. package/codeyam-cli/src/utils/editorScenarioSwitch.js.map +1 -0
  729. package/codeyam-cli/src/utils/editorScenarios.js +687 -0
  730. package/codeyam-cli/src/utils/editorScenarios.js.map +1 -0
  731. package/codeyam-cli/src/utils/editorSeedAdapter.js +475 -0
  732. package/codeyam-cli/src/utils/editorSeedAdapter.js.map +1 -0
  733. package/codeyam-cli/src/utils/editorShouldRevalidate.js +21 -0
  734. package/codeyam-cli/src/utils/editorShouldRevalidate.js.map +1 -0
  735. package/codeyam-cli/src/utils/entityChangeStatus.js +394 -0
  736. package/codeyam-cli/src/utils/entityChangeStatus.js.map +1 -0
  737. package/codeyam-cli/src/utils/entityChangeStatus.server.js +227 -0
  738. package/codeyam-cli/src/utils/entityChangeStatus.server.js.map +1 -0
  739. package/codeyam-cli/src/utils/fileMetadata.js +5 -0
  740. package/codeyam-cli/src/utils/fileMetadata.js.map +1 -1
  741. package/codeyam-cli/src/utils/fileWatcher.js +63 -9
  742. package/codeyam-cli/src/utils/fileWatcher.js.map +1 -1
  743. package/codeyam-cli/src/utils/generateReport.js +253 -106
  744. package/codeyam-cli/src/utils/generateReport.js.map +1 -1
  745. package/codeyam-cli/src/utils/git.js +182 -0
  746. package/codeyam-cli/src/utils/git.js.map +1 -0
  747. package/codeyam-cli/src/utils/glossaryAdd.js +74 -0
  748. package/codeyam-cli/src/utils/glossaryAdd.js.map +1 -0
  749. package/codeyam-cli/src/utils/install-skills.js +134 -44
  750. package/codeyam-cli/src/utils/install-skills.js.map +1 -1
  751. package/codeyam-cli/src/utils/interactiveSyncWatcher.js +126 -0
  752. package/codeyam-cli/src/utils/interactiveSyncWatcher.js.map +1 -0
  753. package/codeyam-cli/src/utils/labsAutoCheck.js +19 -0
  754. package/codeyam-cli/src/utils/labsAutoCheck.js.map +1 -0
  755. package/codeyam-cli/src/utils/manualEntityAnalysis.js +196 -0
  756. package/codeyam-cli/src/utils/manualEntityAnalysis.js.map +1 -0
  757. package/codeyam-cli/src/utils/npmVersionCheck.js +76 -0
  758. package/codeyam-cli/src/utils/npmVersionCheck.js.map +1 -0
  759. package/codeyam-cli/src/utils/parseRegisterArg.js +31 -0
  760. package/codeyam-cli/src/utils/parseRegisterArg.js.map +1 -0
  761. package/codeyam-cli/src/utils/pathIgnoring.js +19 -7
  762. package/codeyam-cli/src/utils/pathIgnoring.js.map +1 -1
  763. package/codeyam-cli/src/utils/progress.js +8 -1
  764. package/codeyam-cli/src/utils/progress.js.map +1 -1
  765. package/codeyam-cli/src/utils/project.js +15 -5
  766. package/codeyam-cli/src/utils/project.js.map +1 -1
  767. package/codeyam-cli/src/utils/queue/__tests__/heartbeat.test.js +11 -11
  768. package/codeyam-cli/src/utils/queue/__tests__/heartbeat.test.js.map +1 -1
  769. package/codeyam-cli/src/utils/queue/__tests__/job.interactiveStart.test.js +159 -0
  770. package/codeyam-cli/src/utils/queue/__tests__/job.interactiveStart.test.js.map +1 -0
  771. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js +60 -0
  772. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js.map +1 -1
  773. package/codeyam-cli/src/utils/queue/heartbeat.js +13 -5
  774. package/codeyam-cli/src/utils/queue/heartbeat.js.map +1 -1
  775. package/codeyam-cli/src/utils/queue/job.js +354 -23
  776. package/codeyam-cli/src/utils/queue/job.js.map +1 -1
  777. package/codeyam-cli/src/utils/queue/manager.js +104 -7
  778. package/codeyam-cli/src/utils/queue/manager.js.map +1 -1
  779. package/codeyam-cli/src/utils/queue/persistence.js.map +1 -1
  780. package/codeyam-cli/src/utils/registerScenarioResult.js +52 -0
  781. package/codeyam-cli/src/utils/registerScenarioResult.js.map +1 -0
  782. package/codeyam-cli/src/utils/requireSimulations.js +10 -0
  783. package/codeyam-cli/src/utils/requireSimulations.js.map +1 -0
  784. package/codeyam-cli/src/utils/routePatternMatching.js +129 -0
  785. package/codeyam-cli/src/utils/routePatternMatching.js.map +1 -0
  786. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js +82 -0
  787. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js.map +1 -0
  788. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js +229 -0
  789. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js.map +1 -0
  790. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js +67 -0
  791. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js.map +1 -0
  792. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js +105 -0
  793. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js.map +1 -0
  794. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js +34 -0
  795. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js.map +1 -0
  796. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js +162 -0
  797. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js.map +1 -0
  798. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js +74 -0
  799. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js.map +1 -0
  800. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js +376 -0
  801. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js.map +1 -0
  802. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js +113 -0
  803. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js.map +1 -0
  804. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js +127 -0
  805. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js.map +1 -0
  806. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js +50 -0
  807. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js.map +1 -0
  808. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js +116 -0
  809. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js.map +1 -0
  810. package/codeyam-cli/src/utils/ruleReflection/index.js +5 -0
  811. package/codeyam-cli/src/utils/ruleReflection/index.js.map +1 -0
  812. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js +44 -0
  813. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js.map +1 -0
  814. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js +85 -0
  815. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js.map +1 -0
  816. package/codeyam-cli/src/utils/ruleReflection/types.js +5 -0
  817. package/codeyam-cli/src/utils/ruleReflection/types.js.map +1 -0
  818. package/codeyam-cli/src/utils/rules/__tests__/parser.test.js +83 -0
  819. package/codeyam-cli/src/utils/rules/__tests__/parser.test.js.map +1 -0
  820. package/codeyam-cli/src/utils/rules/__tests__/pathMatcher.test.js +118 -0
  821. package/codeyam-cli/src/utils/rules/__tests__/pathMatcher.test.js.map +1 -0
  822. package/codeyam-cli/src/utils/rules/__tests__/rulePlacement.test.js +72 -0
  823. package/codeyam-cli/src/utils/rules/__tests__/rulePlacement.test.js.map +1 -0
  824. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js +293 -0
  825. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js.map +1 -0
  826. package/codeyam-cli/src/utils/rules/__tests__/sourceFiles.test.js +76 -0
  827. package/codeyam-cli/src/utils/rules/__tests__/sourceFiles.test.js.map +1 -0
  828. package/codeyam-cli/src/utils/rules/index.js +7 -0
  829. package/codeyam-cli/src/utils/rules/index.js.map +1 -0
  830. package/codeyam-cli/src/utils/rules/parser.js +93 -0
  831. package/codeyam-cli/src/utils/rules/parser.js.map +1 -0
  832. package/codeyam-cli/src/utils/rules/pathMatcher.js +49 -0
  833. package/codeyam-cli/src/utils/rules/pathMatcher.js.map +1 -0
  834. package/codeyam-cli/src/utils/rules/rulePlacement.js +65 -0
  835. package/codeyam-cli/src/utils/rules/rulePlacement.js.map +1 -0
  836. package/codeyam-cli/src/utils/rules/ruleState.js +150 -0
  837. package/codeyam-cli/src/utils/rules/ruleState.js.map +1 -0
  838. package/codeyam-cli/src/utils/rules/sourceFiles.js +43 -0
  839. package/codeyam-cli/src/utils/rules/sourceFiles.js.map +1 -0
  840. package/codeyam-cli/src/utils/rules/staleness.js +137 -0
  841. package/codeyam-cli/src/utils/rules/staleness.js.map +1 -0
  842. package/codeyam-cli/src/utils/scenarioCoverage.js +77 -0
  843. package/codeyam-cli/src/utils/scenarioCoverage.js.map +1 -0
  844. package/codeyam-cli/src/utils/scenarioMarkers.js +134 -0
  845. package/codeyam-cli/src/utils/scenarioMarkers.js.map +1 -0
  846. package/codeyam-cli/src/utils/scenariosManifest.js +313 -0
  847. package/codeyam-cli/src/utils/scenariosManifest.js.map +1 -0
  848. package/codeyam-cli/src/utils/screenshotHash.js +26 -0
  849. package/codeyam-cli/src/utils/screenshotHash.js.map +1 -0
  850. package/codeyam-cli/src/utils/serverState.js +94 -12
  851. package/codeyam-cli/src/utils/serverState.js.map +1 -1
  852. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js +96 -45
  853. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js.map +1 -1
  854. package/codeyam-cli/src/utils/simulationGateMiddleware.js +175 -0
  855. package/codeyam-cli/src/utils/simulationGateMiddleware.js.map +1 -0
  856. package/codeyam-cli/src/utils/slugUtils.js +25 -0
  857. package/codeyam-cli/src/utils/slugUtils.js.map +1 -0
  858. package/codeyam-cli/src/utils/syncMocksMiddleware.js +7 -26
  859. package/codeyam-cli/src/utils/syncMocksMiddleware.js.map +1 -1
  860. package/codeyam-cli/src/utils/telemetry.js +106 -0
  861. package/codeyam-cli/src/utils/telemetry.js.map +1 -0
  862. package/codeyam-cli/src/utils/telemetryMiddleware.js +22 -0
  863. package/codeyam-cli/src/utils/telemetryMiddleware.js.map +1 -0
  864. package/codeyam-cli/src/utils/testResultCache.js +53 -0
  865. package/codeyam-cli/src/utils/testResultCache.js.map +1 -0
  866. package/codeyam-cli/src/utils/testResultCache.server.js +81 -0
  867. package/codeyam-cli/src/utils/testResultCache.server.js.map +1 -0
  868. package/codeyam-cli/src/utils/testResultCache.server.test.js +187 -0
  869. package/codeyam-cli/src/utils/testResultCache.server.test.js.map +1 -0
  870. package/codeyam-cli/src/utils/testResultCache.test.js +230 -0
  871. package/codeyam-cli/src/utils/testResultCache.test.js.map +1 -0
  872. package/codeyam-cli/src/utils/testRunner.js +350 -0
  873. package/codeyam-cli/src/utils/testRunner.js.map +1 -0
  874. package/codeyam-cli/src/utils/transcriptPruning.js +67 -0
  875. package/codeyam-cli/src/utils/transcriptPruning.js.map +1 -0
  876. package/codeyam-cli/src/utils/versionInfo.js +67 -15
  877. package/codeyam-cli/src/utils/versionInfo.js.map +1 -1
  878. package/codeyam-cli/src/utils/webappDetection.js +38 -3
  879. package/codeyam-cli/src/utils/webappDetection.js.map +1 -1
  880. package/codeyam-cli/src/utils/wipe.js +128 -0
  881. package/codeyam-cli/src/utils/wipe.js.map +1 -0
  882. package/codeyam-cli/src/webserver/__tests__/api.interactive-switch-scenario.test.js +99 -0
  883. package/codeyam-cli/src/webserver/__tests__/api.interactive-switch-scenario.test.js.map +1 -0
  884. package/codeyam-cli/src/webserver/__tests__/buildPtyEnv.test.js +35 -0
  885. package/codeyam-cli/src/webserver/__tests__/buildPtyEnv.test.js.map +1 -0
  886. package/codeyam-cli/src/webserver/__tests__/clientErrors.test.js +107 -0
  887. package/codeyam-cli/src/webserver/__tests__/clientErrors.test.js.map +1 -0
  888. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js +66 -0
  889. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js.map +1 -0
  890. package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js +647 -0
  891. package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js.map +1 -0
  892. package/codeyam-cli/src/webserver/__tests__/idleDetector.test.js +315 -0
  893. package/codeyam-cli/src/webserver/__tests__/idleDetector.test.js.map +1 -0
  894. package/codeyam-cli/src/webserver/__tests__/stripClaudeCommand.test.js +135 -0
  895. package/codeyam-cli/src/webserver/__tests__/stripClaudeCommand.test.js.map +1 -0
  896. package/codeyam-cli/src/webserver/app/lib/clientErrors.js +86 -0
  897. package/codeyam-cli/src/webserver/app/lib/clientErrors.js.map +1 -0
  898. package/codeyam-cli/src/webserver/app/lib/database.js +159 -33
  899. package/codeyam-cli/src/webserver/app/lib/database.js.map +1 -1
  900. package/codeyam-cli/src/webserver/app/lib/dbNotifier.js.map +1 -1
  901. package/codeyam-cli/src/webserver/app/lib/git.js +397 -0
  902. package/codeyam-cli/src/webserver/app/lib/git.js.map +1 -0
  903. package/codeyam-cli/src/webserver/app/routes/api.interactive-switch-scenario.js +34 -0
  904. package/codeyam-cli/src/webserver/app/routes/api.interactive-switch-scenario.js.map +1 -0
  905. package/codeyam-cli/src/webserver/app/types/editor.js +8 -0
  906. package/codeyam-cli/src/webserver/app/types/editor.js.map +1 -0
  907. package/codeyam-cli/src/webserver/backgroundServer.js +191 -47
  908. package/codeyam-cli/src/webserver/backgroundServer.js.map +1 -1
  909. package/codeyam-cli/src/webserver/bootstrap.js +60 -0
  910. package/codeyam-cli/src/webserver/bootstrap.js.map +1 -0
  911. package/codeyam-cli/src/webserver/build/client/assets/CopyButton-DTBZZfSk.js +1 -0
  912. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-BxclONWq.js +11 -0
  913. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeBadge-CQgyEGV-.js +1 -0
  914. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-BsnEOJZ_.js +41 -0
  915. package/codeyam-cli/src/webserver/build/client/assets/InlineSpinner-ByaELMbv.js +1 -0
  916. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-6WjVfhxX.js +25 -0
  917. package/codeyam-cli/src/webserver/build/client/assets/LibraryFunctionPreview-ChX-Hp7W.js +3 -0
  918. package/codeyam-cli/src/webserver/build/client/assets/LoadingDots-By5zI316.js +6 -0
  919. package/codeyam-cli/src/webserver/build/client/assets/LogViewer-C-9zQdXg.js +3 -0
  920. package/codeyam-cli/src/webserver/build/client/assets/MiniClaudeChat-BusrvT2F.js +36 -0
  921. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-DQsceHVv.js +11 -0
  922. package/codeyam-cli/src/webserver/build/client/assets/SafeScreenshot-DThcm_9M.js +1 -0
  923. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-Cl4oOA3A.js +10 -0
  924. package/codeyam-cli/src/webserver/build/client/assets/Spinner-CIil5-gb.js +34 -0
  925. package/codeyam-cli/src/webserver/build/client/assets/TruncatedFilePath-CK7-NaPZ.js +1 -0
  926. package/codeyam-cli/src/webserver/build/client/assets/ViewportInspectBar-BqkA9zyZ.js +1 -0
  927. package/codeyam-cli/src/webserver/build/client/assets/_index-DnOgyseQ.js +11 -0
  928. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-DqM9hbNE.js +27 -0
  929. package/codeyam-cli/src/webserver/build/client/assets/addon-canvas-DpzMmAy5.js +1 -0
  930. package/codeyam-cli/src/webserver/build/client/assets/addon-fit-YJmn1quW.js +12 -0
  931. package/codeyam-cli/src/webserver/build/client/assets/addon-web-links-C58dYPwR.js +1 -0
  932. package/codeyam-cli/src/webserver/build/client/assets/addon-webgl-DI8QOUvO.js +58 -0
  933. package/codeyam-cli/src/webserver/build/client/assets/agent-transcripts-B8NCeOrm.js +22 -0
  934. package/codeyam-cli/src/webserver/build/client/assets/api.agent-transcripts-l0sNRNKZ.js +1 -0
  935. package/codeyam-cli/src/webserver/build/client/assets/api.dev-mode-events-l0sNRNKZ.js +1 -0
  936. package/codeyam-cli/src/webserver/build/client/assets/api.editor-audit-l0sNRNKZ.js +1 -0
  937. package/codeyam-cli/src/webserver/build/client/assets/api.editor-capture-scenario-l0sNRNKZ.js +1 -0
  938. package/codeyam-cli/src/webserver/build/client/assets/api.editor-client-errors-l0sNRNKZ.js +1 -0
  939. package/codeyam-cli/src/webserver/build/client/assets/api.editor-commit-l0sNRNKZ.js +1 -0
  940. package/codeyam-cli/src/webserver/build/client/assets/api.editor-dev-server-l0sNRNKZ.js +1 -0
  941. package/codeyam-cli/src/webserver/build/client/assets/api.editor-entity-status-l0sNRNKZ.js +1 -0
  942. package/codeyam-cli/src/webserver/build/client/assets/api.editor-file-diff-l0sNRNKZ.js +1 -0
  943. package/codeyam-cli/src/webserver/build/client/assets/api.editor-file-l0sNRNKZ.js +1 -0
  944. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-entry-l0sNRNKZ.js +1 -0
  945. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-image._-l0sNRNKZ.js +1 -0
  946. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-l0sNRNKZ.js +1 -0
  947. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-screenshot-l0sNRNKZ.js +1 -0
  948. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-update-l0sNRNKZ.js +1 -0
  949. package/codeyam-cli/src/webserver/build/client/assets/api.editor-load-commit-l0sNRNKZ.js +1 -0
  950. package/codeyam-cli/src/webserver/build/client/assets/api.editor-project-info-l0sNRNKZ.js +1 -0
  951. package/codeyam-cli/src/webserver/build/client/assets/api.editor-recapture-stale-l0sNRNKZ.js +1 -0
  952. package/codeyam-cli/src/webserver/build/client/assets/api.editor-refresh-l0sNRNKZ.js +1 -0
  953. package/codeyam-cli/src/webserver/build/client/assets/api.editor-register-scenario-l0sNRNKZ.js +1 -0
  954. package/codeyam-cli/src/webserver/build/client/assets/api.editor-rename-scenario-l0sNRNKZ.js +1 -0
  955. package/codeyam-cli/src/webserver/build/client/assets/api.editor-roadmap-l0sNRNKZ.js +1 -0
  956. package/codeyam-cli/src/webserver/build/client/assets/api.editor-save-scenario-data-l0sNRNKZ.js +1 -0
  957. package/codeyam-cli/src/webserver/build/client/assets/api.editor-save-seed-state-l0sNRNKZ.js +1 -0
  958. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-coverage-l0sNRNKZ.js +1 -0
  959. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-data-l0sNRNKZ.js +1 -0
  960. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-image._-l0sNRNKZ.js +1 -0
  961. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-prompt-l0sNRNKZ.js +1 -0
  962. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenarios-l0sNRNKZ.js +1 -0
  963. package/codeyam-cli/src/webserver/build/client/assets/api.editor-schema-l0sNRNKZ.js +1 -0
  964. package/codeyam-cli/src/webserver/build/client/assets/api.editor-session-l0sNRNKZ.js +1 -0
  965. package/codeyam-cli/src/webserver/build/client/assets/api.editor-switch-scenario-l0sNRNKZ.js +1 -0
  966. package/codeyam-cli/src/webserver/build/client/assets/api.editor-test-results-l0sNRNKZ.js +1 -0
  967. package/codeyam-cli/src/webserver/build/client/assets/api.editor-verify-routes-l0sNRNKZ.js +1 -0
  968. package/codeyam-cli/src/webserver/build/client/assets/api.health-l0sNRNKZ.js +1 -0
  969. package/codeyam-cli/src/webserver/build/client/assets/api.interactive-switch-scenario-l0sNRNKZ.js +1 -0
  970. package/codeyam-cli/src/webserver/build/client/assets/api.labs-unlock-l0sNRNKZ.js +1 -0
  971. package/codeyam-cli/src/webserver/build/client/assets/api.memory-profile-l0sNRNKZ.js +1 -0
  972. package/codeyam-cli/src/webserver/build/client/assets/api.restart-server-l0sNRNKZ.js +1 -0
  973. package/codeyam-cli/src/webserver/build/client/assets/api.rule-path-l0sNRNKZ.js +1 -0
  974. package/codeyam-cli/src/webserver/build/client/assets/api.save-fixture-l0sNRNKZ.js +1 -0
  975. package/codeyam-cli/src/webserver/build/client/assets/book-open-BFSIqZgO.js +6 -0
  976. package/codeyam-cli/src/webserver/build/client/assets/chevron-down-B9fDzFVh.js +6 -0
  977. package/codeyam-cli/src/webserver/build/client/assets/chunk-UVKPFVEO-Bmq2apuh.js +43 -0
  978. package/codeyam-cli/src/webserver/build/client/assets/circle-check-DLPObLUx.js +6 -0
  979. package/codeyam-cli/src/webserver/build/client/assets/copy-DXEmO0TD.js +11 -0
  980. package/codeyam-cli/src/webserver/build/client/assets/createLucideIcon-BwyFiRot.js +41 -0
  981. package/codeyam-cli/src/webserver/build/client/assets/cy-logo-cli-Coe5NhbS.js +1 -0
  982. package/codeyam-cli/src/webserver/build/client/assets/{cy-logo-cli-C1gnJVOL.svg → cy-logo-cli-DoA97ML3.svg} +2 -2
  983. package/codeyam-cli/src/webserver/build/client/assets/{dev.empty-CT0Q5lVu.js → dev.empty-iRhRIFlp.js} +1 -1
  984. package/codeyam-cli/src/webserver/build/client/assets/editor._tab-BZPBzV73.js +1 -0
  985. package/codeyam-cli/src/webserver/build/client/assets/editor.entity.(_sha)-785deXbZ.js +147 -0
  986. package/codeyam-cli/src/webserver/build/client/assets/editorPreview-C6fEYHrh.js +41 -0
  987. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha._-CYqBrC9s.js → entity._sha._-Ce1s4OQ1.js} +23 -15
  988. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.dev-C8AyYgYT.js +6 -0
  989. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-DziaVQX1.js +6 -0
  990. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-BTcpgIpC.js +6 -0
  991. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.edit._scenarioId-D_O_ajfZ.js +5 -0
  992. package/codeyam-cli/src/webserver/build/client/assets/entry.client-j1Vi0bco.js +29 -0
  993. package/codeyam-cli/src/webserver/build/client/assets/executionFlowCoverage-BWhdfn70.js +1 -0
  994. package/codeyam-cli/src/webserver/build/client/assets/fileTableUtils-Daa96Fr1.js +1 -0
  995. package/codeyam-cli/src/webserver/build/client/assets/files-kuny2Q_s.js +1 -0
  996. package/codeyam-cli/src/webserver/build/client/assets/git-DgCZPMie.js +1 -0
  997. package/codeyam-cli/src/webserver/build/client/assets/globals-Bt7TsgQz.css +1 -0
  998. package/codeyam-cli/src/webserver/build/client/assets/html2canvas-pro.esm-fmIEn3Bc.js +9 -0
  999. package/codeyam-cli/src/webserver/build/client/assets/index-BliGSSpl.js +3 -0
  1000. package/codeyam-cli/src/webserver/build/client/assets/index-SqjQKTdH.js +15 -0
  1001. package/codeyam-cli/src/webserver/build/client/assets/index-vyrZD2g4.js +9 -0
  1002. package/codeyam-cli/src/webserver/build/client/assets/jsx-runtime-D_zvdyIk.js +9 -0
  1003. package/codeyam-cli/src/webserver/build/client/assets/labs-c3yLxSEp.js +1 -0
  1004. package/codeyam-cli/src/webserver/build/client/assets/loader-circle-D-q28GLF.js +6 -0
  1005. package/codeyam-cli/src/webserver/build/client/assets/manifest-3d8cde80.js +1 -0
  1006. package/codeyam-cli/src/webserver/build/client/assets/memory-CEWIUC4t.js +101 -0
  1007. package/codeyam-cli/src/webserver/build/client/assets/pause-BP6fitdh.js +11 -0
  1008. package/codeyam-cli/src/webserver/build/client/assets/preload-helper-ckwbz45p.js +1 -0
  1009. package/codeyam-cli/src/webserver/build/client/assets/root-CVjDQwjJ.js +80 -0
  1010. package/codeyam-cli/src/webserver/build/client/assets/scenarioStatus-B_8jpV3e.js +1 -0
  1011. package/codeyam-cli/src/webserver/build/client/assets/search-BooqacKS.js +6 -0
  1012. package/codeyam-cli/src/webserver/build/client/assets/settings-BM0nbryO.js +1 -0
  1013. package/codeyam-cli/src/webserver/build/client/assets/simulations-ovy6FjRY.js +1 -0
  1014. package/codeyam-cli/src/webserver/build/client/assets/terminal-DHemCJIs.js +11 -0
  1015. package/codeyam-cli/src/webserver/build/client/assets/triangle-alert-D87ekDl8.js +6 -0
  1016. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-Dk0Tciqg.js +1 -0
  1017. package/codeyam-cli/src/webserver/build/client/assets/useLastLogLine-C8QvIe05.js +2 -0
  1018. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-jkCytuYz.js +1 -0
  1019. package/codeyam-cli/src/webserver/build/client/assets/useToast-BgqkixU9.js +1 -0
  1020. package/codeyam-cli/src/webserver/build/client/assets/xterm-BqvuqXEL.js +27 -0
  1021. package/codeyam-cli/src/webserver/build/client/sound-test.html +98 -0
  1022. package/codeyam-cli/src/webserver/build/server/assets/analysisRunner-CTJYMVFP.js +16 -0
  1023. package/codeyam-cli/src/webserver/build/server/assets/index-CCth4Hgw.js +1 -0
  1024. package/codeyam-cli/src/webserver/build/server/assets/init-UXl-3vVp.js +10 -0
  1025. package/codeyam-cli/src/webserver/build/server/assets/progress-CHTtrxFG.js +1 -0
  1026. package/codeyam-cli/src/webserver/build/server/assets/server-build-DSW2mE30.js +741 -0
  1027. package/codeyam-cli/src/webserver/build/server/index.js +1 -1
  1028. package/codeyam-cli/src/webserver/build-info.json +5 -5
  1029. package/codeyam-cli/src/webserver/devServer.js +40 -8
  1030. package/codeyam-cli/src/webserver/devServer.js.map +1 -1
  1031. package/codeyam-cli/src/webserver/editorProxy.js +1028 -0
  1032. package/codeyam-cli/src/webserver/editorProxy.js.map +1 -0
  1033. package/codeyam-cli/src/webserver/idleDetector.js +130 -0
  1034. package/codeyam-cli/src/webserver/idleDetector.js.map +1 -0
  1035. package/codeyam-cli/src/webserver/mockStateEvents.js +28 -0
  1036. package/codeyam-cli/src/webserver/mockStateEvents.js.map +1 -0
  1037. package/codeyam-cli/src/webserver/public/sound-test.html +98 -0
  1038. package/codeyam-cli/src/webserver/scripts/codeyam-preload.mjs +414 -0
  1039. package/codeyam-cli/src/webserver/scripts/journalCapture.ts +283 -0
  1040. package/codeyam-cli/src/webserver/server.js +481 -26
  1041. package/codeyam-cli/src/webserver/server.js.map +1 -1
  1042. package/codeyam-cli/src/webserver/terminalServer.js +973 -0
  1043. package/codeyam-cli/src/webserver/terminalServer.js.map +1 -0
  1044. package/codeyam-cli/templates/__tests__/editor-step-hook.prompt-capture.test.ts +118 -0
  1045. package/codeyam-cli/templates/chrome-extension-react/EXTENSION_SETUP.md +75 -0
  1046. package/codeyam-cli/templates/chrome-extension-react/README.md +46 -0
  1047. package/codeyam-cli/templates/chrome-extension-react/gitignore +15 -0
  1048. package/codeyam-cli/templates/chrome-extension-react/index.html +12 -0
  1049. package/codeyam-cli/templates/chrome-extension-react/package.json +27 -0
  1050. package/codeyam-cli/templates/chrome-extension-react/popup.html +12 -0
  1051. package/codeyam-cli/templates/chrome-extension-react/public/manifest.json +15 -0
  1052. package/codeyam-cli/templates/chrome-extension-react/src/background/service-worker.ts +7 -0
  1053. package/codeyam-cli/templates/chrome-extension-react/src/globals.css +6 -0
  1054. package/codeyam-cli/templates/chrome-extension-react/src/lib/storage.ts +37 -0
  1055. package/codeyam-cli/templates/chrome-extension-react/src/popup/App.tsx +12 -0
  1056. package/codeyam-cli/templates/chrome-extension-react/src/popup/main.tsx +10 -0
  1057. package/codeyam-cli/templates/chrome-extension-react/tsconfig.json +24 -0
  1058. package/codeyam-cli/templates/chrome-extension-react/vite.config.ts +41 -0
  1059. package/codeyam-cli/templates/codeyam-editor-claude.md +149 -0
  1060. package/codeyam-cli/templates/codeyam-editor-reference.md +216 -0
  1061. package/codeyam-cli/templates/codeyam-memory-hook.sh +199 -0
  1062. package/codeyam-cli/templates/commands/codeyam-diagnose.md +481 -0
  1063. package/codeyam-cli/templates/design-systems/clean-dashboard-design-system.md +255 -0
  1064. package/codeyam-cli/templates/design-systems/editorial-design-system.md +267 -0
  1065. package/codeyam-cli/templates/design-systems/mono-brutalist-design-system.md +256 -0
  1066. package/codeyam-cli/templates/design-systems/neo-brutalist-design-system.md +294 -0
  1067. package/codeyam-cli/templates/editor-step-hook.py +368 -0
  1068. package/codeyam-cli/templates/expo-react-native/MOBILE_SETUP.md +288 -0
  1069. package/codeyam-cli/templates/expo-react-native/README.md +41 -0
  1070. package/codeyam-cli/templates/expo-react-native/__tests__/.gitkeep +0 -0
  1071. package/codeyam-cli/templates/expo-react-native/app/_layout.tsx +15 -0
  1072. package/codeyam-cli/templates/expo-react-native/app/index.tsx +36 -0
  1073. package/codeyam-cli/templates/expo-react-native/app.json +29 -0
  1074. package/codeyam-cli/templates/expo-react-native/babel.config.js +10 -0
  1075. package/codeyam-cli/templates/expo-react-native/gitignore +14 -0
  1076. package/codeyam-cli/templates/expo-react-native/global.css +10 -0
  1077. package/codeyam-cli/templates/expo-react-native/lib/storage.ts +32 -0
  1078. package/codeyam-cli/templates/expo-react-native/lib/theme.ts +73 -0
  1079. package/codeyam-cli/templates/expo-react-native/metro.config.js +6 -0
  1080. package/codeyam-cli/templates/expo-react-native/nativewind-env.d.ts +1 -0
  1081. package/codeyam-cli/templates/expo-react-native/package.json +54 -0
  1082. package/codeyam-cli/templates/expo-react-native/patches/expo-modules-autolinking+3.0.24.patch +29 -0
  1083. package/codeyam-cli/templates/expo-react-native/tailwind.config.js +10 -0
  1084. package/codeyam-cli/templates/expo-react-native/tsconfig.json +10 -0
  1085. package/codeyam-cli/templates/hooks/staleness-check.sh +43 -0
  1086. package/codeyam-cli/templates/isolation-route/expo-router.tsx.template +54 -0
  1087. package/codeyam-cli/templates/isolation-route/next-app.tsx.template +80 -0
  1088. package/codeyam-cli/templates/isolation-route/next-pages.tsx.template +79 -0
  1089. package/codeyam-cli/templates/isolation-route/vite-react.tsx.template +78 -0
  1090. package/codeyam-cli/templates/msw/browser-setup.ts.template +47 -0
  1091. package/codeyam-cli/templates/msw/handler-router.ts.template +47 -0
  1092. package/codeyam-cli/templates/msw/server-setup.ts.template +52 -0
  1093. package/codeyam-cli/templates/nextjs-prisma-sqlite/AUTH_PATTERNS.md +308 -0
  1094. package/codeyam-cli/templates/nextjs-prisma-sqlite/AUTH_UPGRADE.md +304 -0
  1095. package/codeyam-cli/templates/nextjs-prisma-sqlite/DATABASE.md +126 -0
  1096. package/codeyam-cli/templates/nextjs-prisma-sqlite/FEATURE_PATTERNS.md +37 -0
  1097. package/codeyam-cli/templates/nextjs-prisma-sqlite/README.md +53 -0
  1098. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/api/todos/route.ts +17 -0
  1099. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/codeyam-isolate/layout.tsx +12 -0
  1100. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/globals.css +26 -0
  1101. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/layout.tsx +34 -0
  1102. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/lib/prisma.ts +24 -0
  1103. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/page.tsx +10 -0
  1104. package/codeyam-cli/templates/nextjs-prisma-sqlite/env +4 -0
  1105. package/codeyam-cli/templates/nextjs-prisma-sqlite/eslint.config.mjs +11 -0
  1106. package/codeyam-cli/templates/nextjs-prisma-sqlite/gitignore +64 -0
  1107. package/codeyam-cli/templates/nextjs-prisma-sqlite/next.config.ts +14 -0
  1108. package/codeyam-cli/templates/nextjs-prisma-sqlite/package.json +39 -0
  1109. package/codeyam-cli/templates/nextjs-prisma-sqlite/postcss.config.mjs +7 -0
  1110. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma/schema.prisma +27 -0
  1111. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma/seed.ts +40 -0
  1112. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma.config.ts +12 -0
  1113. package/codeyam-cli/templates/nextjs-prisma-sqlite/seed-adapter.ts +140 -0
  1114. package/codeyam-cli/templates/nextjs-prisma-sqlite/tsconfig.json +34 -0
  1115. package/codeyam-cli/templates/nextjs-prisma-sqlite/vitest.config.ts +13 -0
  1116. package/codeyam-cli/templates/nextjs-prisma-supabase/README.md +52 -0
  1117. package/codeyam-cli/templates/nextjs-prisma-supabase/SUPABASE_SETUP.md +104 -0
  1118. package/codeyam-cli/templates/nextjs-prisma-supabase/app/api/todos/route.ts +17 -0
  1119. package/codeyam-cli/templates/nextjs-prisma-supabase/app/globals.css +26 -0
  1120. package/codeyam-cli/templates/nextjs-prisma-supabase/app/layout.tsx +34 -0
  1121. package/codeyam-cli/templates/nextjs-prisma-supabase/app/lib/prisma.ts +20 -0
  1122. package/codeyam-cli/templates/nextjs-prisma-supabase/app/lib/supabase.ts +12 -0
  1123. package/codeyam-cli/templates/nextjs-prisma-supabase/app/page.tsx +10 -0
  1124. package/codeyam-cli/templates/nextjs-prisma-supabase/env +9 -0
  1125. package/codeyam-cli/templates/nextjs-prisma-supabase/eslint.config.mjs +11 -0
  1126. package/codeyam-cli/templates/nextjs-prisma-supabase/gitignore +40 -0
  1127. package/codeyam-cli/templates/nextjs-prisma-supabase/next.config.ts +11 -0
  1128. package/codeyam-cli/templates/nextjs-prisma-supabase/package.json +37 -0
  1129. package/codeyam-cli/templates/nextjs-prisma-supabase/postcss.config.mjs +7 -0
  1130. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma/schema.prisma +27 -0
  1131. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma/seed.ts +39 -0
  1132. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma.config.ts +12 -0
  1133. package/codeyam-cli/templates/nextjs-prisma-supabase/tsconfig.json +34 -0
  1134. package/codeyam-cli/templates/prompts/conversation-guidance.txt +44 -0
  1135. package/codeyam-cli/templates/prompts/conversation-prompt.txt +28 -0
  1136. package/codeyam-cli/templates/prompts/interruption-prompt.txt +31 -0
  1137. package/codeyam-cli/templates/prompts/stale-rules-prompt.txt +24 -0
  1138. package/codeyam-cli/templates/rule-notification-hook.py +83 -0
  1139. package/codeyam-cli/templates/rule-reflection-hook.py +647 -0
  1140. package/codeyam-cli/templates/rules-instructions.md +78 -0
  1141. package/codeyam-cli/templates/seed-adapters/supabase.ts +374 -0
  1142. package/codeyam-cli/templates/{codeyam-debug-skill.md → skills/codeyam-debug/SKILL.md} +48 -4
  1143. package/codeyam-cli/templates/skills/codeyam-dev-mode/SKILL.md +237 -0
  1144. package/codeyam-cli/templates/skills/codeyam-editor/SKILL.md +244 -0
  1145. package/codeyam-cli/templates/skills/codeyam-memory/SKILL.md +611 -0
  1146. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/deprecated-prompt.md +100 -0
  1147. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/detect-deprecated-patterns.mjs +139 -0
  1148. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/find-exports.mjs +52 -0
  1149. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/misleading-api-prompt.md +117 -0
  1150. package/codeyam-cli/templates/skills/codeyam-memory/scripts/lib/read-json-field.mjs +61 -0
  1151. package/codeyam-cli/templates/skills/codeyam-memory/scripts/lib/ripgrep-fallback.mjs +155 -0
  1152. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/analyze-prompt.md +46 -0
  1153. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/cleanup.mjs +13 -0
  1154. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/filter-session.mjs +95 -0
  1155. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/preprocess.mjs +160 -0
  1156. package/codeyam-cli/templates/skills/codeyam-new-rule/SKILL.md +11 -0
  1157. package/codeyam-cli/templates/{codeyam-setup-skill.md → skills/codeyam-setup/SKILL.md} +151 -4
  1158. package/codeyam-cli/templates/{codeyam-sim-skill.md → skills/codeyam-sim/SKILL.md} +1 -1
  1159. package/codeyam-cli/templates/{codeyam-test-skill.md → skills/codeyam-test/SKILL.md} +1 -1
  1160. package/codeyam-cli/templates/{codeyam-verify-skill.md → skills/codeyam-verify/SKILL.md} +1 -1
  1161. package/package.json +40 -29
  1162. package/packages/ai/index.js +8 -6
  1163. package/packages/ai/index.js.map +1 -1
  1164. package/packages/ai/src/lib/analyzeScope.js +181 -13
  1165. package/packages/ai/src/lib/analyzeScope.js.map +1 -1
  1166. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js +150 -0
  1167. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js.map +1 -0
  1168. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js +176 -13
  1169. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js.map +1 -1
  1170. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js +435 -0
  1171. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js.map +1 -0
  1172. package/packages/ai/src/lib/astScopes/methodSemantics.js +237 -23
  1173. package/packages/ai/src/lib/astScopes/methodSemantics.js.map +1 -1
  1174. package/packages/ai/src/lib/astScopes/nodeToSource.js +16 -0
  1175. package/packages/ai/src/lib/astScopes/nodeToSource.js.map +1 -1
  1176. package/packages/ai/src/lib/astScopes/paths.js +12 -3
  1177. package/packages/ai/src/lib/astScopes/paths.js.map +1 -1
  1178. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js +10 -14
  1179. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js.map +1 -1
  1180. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js +8 -0
  1181. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js.map +1 -1
  1182. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js +23 -0
  1183. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js.map +1 -1
  1184. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js +138 -1
  1185. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js.map +1 -1
  1186. package/packages/ai/src/lib/astScopes/processExpression.js +1235 -104
  1187. package/packages/ai/src/lib/astScopes/processExpression.js.map +1 -1
  1188. package/packages/ai/src/lib/astScopes/sharedPatterns.js +25 -0
  1189. package/packages/ai/src/lib/astScopes/sharedPatterns.js.map +1 -1
  1190. package/packages/ai/src/lib/checkAllAttributes.js +24 -9
  1191. package/packages/ai/src/lib/checkAllAttributes.js.map +1 -1
  1192. package/packages/ai/src/lib/completionCall.js +188 -38
  1193. package/packages/ai/src/lib/completionCall.js.map +1 -1
  1194. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js +2219 -234
  1195. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js.map +1 -1
  1196. package/packages/ai/src/lib/dataStructure/equivalencyManagers/ParentScopeManager.js +9 -2
  1197. package/packages/ai/src/lib/dataStructure/equivalencyManagers/ParentScopeManager.js.map +1 -1
  1198. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js +19 -4
  1199. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js.map +1 -1
  1200. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js +661 -0
  1201. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js.map +1 -0
  1202. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js +180 -56
  1203. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js.map +1 -1
  1204. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js +13 -3
  1205. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js.map +1 -1
  1206. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js +6 -4
  1207. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js.map +1 -1
  1208. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js +80 -6
  1209. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js.map +1 -1
  1210. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js +139 -13
  1211. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js.map +1 -1
  1212. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js +63 -0
  1213. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js.map +1 -0
  1214. package/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.js +54 -0
  1215. package/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.js.map +1 -0
  1216. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js +142 -12
  1217. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js.map +1 -1
  1218. package/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.js +86 -0
  1219. package/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.js.map +1 -0
  1220. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js +173 -0
  1221. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js.map +1 -0
  1222. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js +37 -20
  1223. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js.map +1 -1
  1224. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js +371 -73
  1225. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js.map +1 -1
  1226. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js +107 -0
  1227. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js.map +1 -0
  1228. package/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.js +34 -0
  1229. package/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.js.map +1 -0
  1230. package/packages/ai/src/lib/dataStructureChunking.js +130 -0
  1231. package/packages/ai/src/lib/dataStructureChunking.js.map +1 -0
  1232. package/packages/ai/src/lib/deepEqual.js +32 -0
  1233. package/packages/ai/src/lib/deepEqual.js.map +1 -0
  1234. package/packages/ai/src/lib/e2eDataTracking.js +241 -0
  1235. package/packages/ai/src/lib/e2eDataTracking.js.map +1 -0
  1236. package/packages/ai/src/lib/extractCriticalDataKeys.js +96 -0
  1237. package/packages/ai/src/lib/extractCriticalDataKeys.js.map +1 -0
  1238. package/packages/ai/src/lib/generateChangesEntityScenarioData.js +62 -5
  1239. package/packages/ai/src/lib/generateChangesEntityScenarioData.js.map +1 -1
  1240. package/packages/ai/src/lib/generateChangesEntityScenarios.js +81 -90
  1241. package/packages/ai/src/lib/generateChangesEntityScenarios.js.map +1 -1
  1242. package/packages/ai/src/lib/generateEntityDataStructure.js +50 -1
  1243. package/packages/ai/src/lib/generateEntityDataStructure.js.map +1 -1
  1244. package/packages/ai/src/lib/generateEntityScenarioData.js +1182 -91
  1245. package/packages/ai/src/lib/generateEntityScenarioData.js.map +1 -1
  1246. package/packages/ai/src/lib/generateEntityScenarios.js +193 -83
  1247. package/packages/ai/src/lib/generateEntityScenarios.js.map +1 -1
  1248. package/packages/ai/src/lib/generateExecutionFlows.js +484 -0
  1249. package/packages/ai/src/lib/generateExecutionFlows.js.map +1 -0
  1250. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js +380 -0
  1251. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js.map +1 -0
  1252. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js +1807 -0
  1253. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js.map +1 -0
  1254. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js +194 -0
  1255. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js.map +1 -0
  1256. package/packages/ai/src/lib/getConditionalUsagesFromCode.js +84 -14
  1257. package/packages/ai/src/lib/getConditionalUsagesFromCode.js.map +1 -1
  1258. package/packages/ai/src/lib/guessScenarioDataFromDescription.js +2 -1
  1259. package/packages/ai/src/lib/guessScenarioDataFromDescription.js.map +1 -1
  1260. package/packages/ai/src/lib/isolateScopes.js +270 -7
  1261. package/packages/ai/src/lib/isolateScopes.js.map +1 -1
  1262. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js +5 -0
  1263. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js.map +1 -1
  1264. package/packages/ai/src/lib/mergeStatements.js +88 -46
  1265. package/packages/ai/src/lib/mergeStatements.js.map +1 -1
  1266. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js +97 -0
  1267. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js.map +1 -0
  1268. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js +16 -4
  1269. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js.map +1 -1
  1270. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js +1 -1
  1271. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js.map +1 -1
  1272. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js +21 -64
  1273. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js.map +1 -1
  1274. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js +54 -0
  1275. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js.map +1 -0
  1276. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js +83 -6
  1277. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js.map +1 -1
  1278. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js +10 -34
  1279. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js.map +1 -1
  1280. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js +45 -0
  1281. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js.map +1 -0
  1282. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js +16 -3
  1283. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js.map +1 -1
  1284. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js +335 -0
  1285. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js.map +1 -0
  1286. package/packages/ai/src/lib/resolvePathToControllable.js +677 -0
  1287. package/packages/ai/src/lib/resolvePathToControllable.js.map +1 -0
  1288. package/packages/ai/src/lib/splitOutsideParentheses.js +3 -1
  1289. package/packages/ai/src/lib/splitOutsideParentheses.js.map +1 -1
  1290. package/packages/ai/src/lib/worker/SerializableDataStructure.js +29 -0
  1291. package/packages/ai/src/lib/worker/SerializableDataStructure.js.map +1 -1
  1292. package/packages/ai/src/lib/worker/analyzeScopeWorker.js +98 -1
  1293. package/packages/ai/src/lib/worker/analyzeScopeWorker.js.map +1 -1
  1294. package/packages/analyze/index.js +2 -1
  1295. package/packages/analyze/index.js.map +1 -1
  1296. package/packages/analyze/src/lib/FileAnalyzer.js +75 -36
  1297. package/packages/analyze/src/lib/FileAnalyzer.js.map +1 -1
  1298. package/packages/analyze/src/lib/ProjectAnalyzer.js +109 -30
  1299. package/packages/analyze/src/lib/ProjectAnalyzer.js.map +1 -1
  1300. package/packages/analyze/src/lib/analysisContext.js +30 -5
  1301. package/packages/analyze/src/lib/analysisContext.js.map +1 -1
  1302. package/packages/analyze/src/lib/asts/index.js +4 -2
  1303. package/packages/analyze/src/lib/asts/index.js.map +1 -1
  1304. package/packages/analyze/src/lib/asts/nodes/getNodeType.js +1 -0
  1305. package/packages/analyze/src/lib/asts/nodes/getNodeType.js.map +1 -1
  1306. package/packages/analyze/src/lib/asts/nodes/index.js +1 -0
  1307. package/packages/analyze/src/lib/asts/nodes/index.js.map +1 -1
  1308. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js +52 -0
  1309. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js.map +1 -0
  1310. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js +14 -0
  1311. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js.map +1 -1
  1312. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js +14 -0
  1313. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js.map +1 -1
  1314. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js +6 -0
  1315. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js.map +1 -1
  1316. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js +6 -0
  1317. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js.map +1 -1
  1318. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js +39 -1
  1319. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js.map +1 -1
  1320. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js +2 -1
  1321. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js.map +1 -1
  1322. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js +442 -123
  1323. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js.map +1 -1
  1324. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js +55 -27
  1325. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js.map +1 -1
  1326. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js +14 -2
  1327. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js.map +1 -1
  1328. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js +11 -8
  1329. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js.map +1 -1
  1330. package/packages/analyze/src/lib/files/analyze/trackEntityCircularDependencies.js +14 -0
  1331. package/packages/analyze/src/lib/files/analyze/trackEntityCircularDependencies.js.map +1 -1
  1332. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js +75 -21
  1333. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js.map +1 -1
  1334. package/packages/analyze/src/lib/files/analyzeChange.js +22 -11
  1335. package/packages/analyze/src/lib/files/analyzeChange.js.map +1 -1
  1336. package/packages/analyze/src/lib/files/analyzeEntity.js +9 -8
  1337. package/packages/analyze/src/lib/files/analyzeEntity.js.map +1 -1
  1338. package/packages/analyze/src/lib/files/analyzeInitial.js +10 -10
  1339. package/packages/analyze/src/lib/files/analyzeInitial.js.map +1 -1
  1340. package/packages/analyze/src/lib/files/analyzeNextRoute.js +5 -1
  1341. package/packages/analyze/src/lib/files/analyzeNextRoute.js.map +1 -1
  1342. package/packages/analyze/src/lib/files/analyzeRemixRoute.js +3 -2
  1343. package/packages/analyze/src/lib/files/analyzeRemixRoute.js.map +1 -1
  1344. package/packages/analyze/src/lib/files/enums/steps.js +1 -1
  1345. package/packages/analyze/src/lib/files/enums/steps.js.map +1 -1
  1346. package/packages/analyze/src/lib/files/getImportedExports.js +17 -8
  1347. package/packages/analyze/src/lib/files/getImportedExports.js.map +1 -1
  1348. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js +907 -0
  1349. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js.map +1 -0
  1350. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js +255 -0
  1351. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js.map +1 -0
  1352. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js +85 -0
  1353. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js.map +1 -0
  1354. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js +550 -62
  1355. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js.map +1 -1
  1356. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.js +1 -1
  1357. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.js.map +1 -1
  1358. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js +29 -34
  1359. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js.map +1 -1
  1360. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js +567 -91
  1361. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js.map +1 -1
  1362. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js +104 -0
  1363. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js.map +1 -0
  1364. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js +56 -69
  1365. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js.map +1 -1
  1366. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js +4 -8
  1367. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js.map +1 -1
  1368. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js +1516 -593
  1369. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js.map +1 -1
  1370. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js +46 -9
  1371. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js.map +1 -1
  1372. package/packages/analyze/src/lib/files/setImportedExports.js +2 -1
  1373. package/packages/analyze/src/lib/files/setImportedExports.js.map +1 -1
  1374. package/packages/analyze/src/lib/index.js +1 -0
  1375. package/packages/analyze/src/lib/index.js.map +1 -1
  1376. package/packages/analyze/src/lib/utils/getFileByPath.js +12 -0
  1377. package/packages/analyze/src/lib/utils/getFileByPath.js.map +1 -0
  1378. package/packages/aws/src/lib/ecs/ecsDefineContainer.js +2 -2
  1379. package/packages/aws/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  1380. package/packages/aws/src/lib/ecs/ecsTaskFactory.js +17 -61
  1381. package/packages/aws/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  1382. package/packages/database/index.js +1 -0
  1383. package/packages/database/index.js.map +1 -1
  1384. package/packages/database/src/lib/analysisBranchToDb.js +1 -1
  1385. package/packages/database/src/lib/analysisBranchToDb.js.map +1 -1
  1386. package/packages/database/src/lib/analysisToDb.js +1 -1
  1387. package/packages/database/src/lib/analysisToDb.js.map +1 -1
  1388. package/packages/database/src/lib/branchToDb.js +1 -1
  1389. package/packages/database/src/lib/branchToDb.js.map +1 -1
  1390. package/packages/database/src/lib/commitBranchToDb.js +1 -1
  1391. package/packages/database/src/lib/commitBranchToDb.js.map +1 -1
  1392. package/packages/database/src/lib/commitToDb.js +1 -1
  1393. package/packages/database/src/lib/commitToDb.js.map +1 -1
  1394. package/packages/database/src/lib/fileToDb.js +1 -1
  1395. package/packages/database/src/lib/fileToDb.js.map +1 -1
  1396. package/packages/database/src/lib/kysely/db.js +18 -3
  1397. package/packages/database/src/lib/kysely/db.js.map +1 -1
  1398. package/packages/database/src/lib/kysely/tables/commitsTable.js +3 -0
  1399. package/packages/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  1400. package/packages/database/src/lib/kysely/tables/debugReportsTable.js +9 -3
  1401. package/packages/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  1402. package/packages/database/src/lib/kysely/tables/editorScenariosTable.js +149 -0
  1403. package/packages/database/src/lib/kysely/tables/editorScenariosTable.js.map +1 -0
  1404. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  1405. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  1406. package/packages/database/src/lib/loadAnalyses.js +45 -2
  1407. package/packages/database/src/lib/loadAnalyses.js.map +1 -1
  1408. package/packages/database/src/lib/loadAnalysis.js +15 -1
  1409. package/packages/database/src/lib/loadAnalysis.js.map +1 -1
  1410. package/packages/database/src/lib/loadBranch.js +11 -1
  1411. package/packages/database/src/lib/loadBranch.js.map +1 -1
  1412. package/packages/database/src/lib/loadCommit.js +7 -0
  1413. package/packages/database/src/lib/loadCommit.js.map +1 -1
  1414. package/packages/database/src/lib/loadCommits.js +45 -14
  1415. package/packages/database/src/lib/loadCommits.js.map +1 -1
  1416. package/packages/database/src/lib/loadEntities.js +23 -10
  1417. package/packages/database/src/lib/loadEntities.js.map +1 -1
  1418. package/packages/database/src/lib/loadEntity.js +5 -5
  1419. package/packages/database/src/lib/loadEntity.js.map +1 -1
  1420. package/packages/database/src/lib/loadEntityBranches.js +9 -0
  1421. package/packages/database/src/lib/loadEntityBranches.js.map +1 -1
  1422. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js +20 -5
  1423. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  1424. package/packages/database/src/lib/projectToDb.js +1 -1
  1425. package/packages/database/src/lib/projectToDb.js.map +1 -1
  1426. package/packages/database/src/lib/saveFiles.js +1 -1
  1427. package/packages/database/src/lib/saveFiles.js.map +1 -1
  1428. package/packages/database/src/lib/scenarioToDb.js +1 -1
  1429. package/packages/database/src/lib/scenarioToDb.js.map +1 -1
  1430. package/packages/database/src/lib/updateCommitMetadata.js +76 -89
  1431. package/packages/database/src/lib/updateCommitMetadata.js.map +1 -1
  1432. package/packages/database/src/lib/updateFreshAnalysisStatus.js +41 -30
  1433. package/packages/database/src/lib/updateFreshAnalysisStatus.js.map +1 -1
  1434. package/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.js +68 -57
  1435. package/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.js.map +1 -1
  1436. package/packages/generate/index.js +3 -0
  1437. package/packages/generate/index.js.map +1 -1
  1438. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  1439. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  1440. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +217 -0
  1441. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  1442. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  1443. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  1444. package/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js +41 -9
  1445. package/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js.map +1 -1
  1446. package/packages/generate/src/lib/deepMerge.js +27 -1
  1447. package/packages/generate/src/lib/deepMerge.js.map +1 -1
  1448. package/packages/generate/src/lib/directExecutionScript.js +10 -1
  1449. package/packages/generate/src/lib/directExecutionScript.js.map +1 -1
  1450. package/packages/generate/src/lib/getComponentScenarioPath.js +7 -3
  1451. package/packages/generate/src/lib/getComponentScenarioPath.js.map +1 -1
  1452. package/packages/generate/src/lib/scenarioComponentForServer.js +89 -0
  1453. package/packages/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  1454. package/packages/github/src/lib/loadOrCreateCommit.js +10 -0
  1455. package/packages/github/src/lib/loadOrCreateCommit.js.map +1 -1
  1456. package/packages/github/src/lib/syncPrimaryBranch.js +3 -0
  1457. package/packages/github/src/lib/syncPrimaryBranch.js.map +1 -1
  1458. package/packages/process/index.js +3 -0
  1459. package/packages/process/index.js.map +1 -0
  1460. package/packages/process/src/GlobalProcessManager.js.map +1 -0
  1461. package/{background/src/lib/process → packages/process/src}/ProcessManager.js +1 -1
  1462. package/packages/process/src/ProcessManager.js.map +1 -0
  1463. package/packages/process/src/index.js.map +1 -0
  1464. package/packages/process/src/managedExecAsync.js.map +1 -0
  1465. package/packages/types/index.js.map +1 -1
  1466. package/packages/types/src/enums/ProjectFramework.js +2 -0
  1467. package/packages/types/src/enums/ProjectFramework.js.map +1 -1
  1468. package/packages/utils/src/lib/applyUniversalMocks.js +26 -2
  1469. package/packages/utils/src/lib/applyUniversalMocks.js.map +1 -1
  1470. package/packages/utils/src/lib/fs/rsyncCopy.js +120 -4
  1471. package/packages/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  1472. package/packages/utils/src/lib/lightweightEntityExtractor.js +25 -0
  1473. package/packages/utils/src/lib/lightweightEntityExtractor.js.map +1 -1
  1474. package/packages/utils/src/lib/safeFileName.js +29 -3
  1475. package/packages/utils/src/lib/safeFileName.js.map +1 -1
  1476. package/scripts/npm-post-install.cjs +34 -0
  1477. package/analyzer-template/packages/ai/src/lib/findMatchingAttribute.ts +0 -102
  1478. package/analyzer-template/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.ts +0 -197
  1479. package/analyzer-template/packages/ai/src/lib/generateChangesEntityKeyAttributes.ts +0 -271
  1480. package/analyzer-template/packages/ai/src/lib/generateEntityKeyAttributes.ts +0 -294
  1481. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.ts +0 -67
  1482. package/analyzer-template/packages/ai/src/lib/transformMockDataToMatchSchema.ts +0 -156
  1483. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.ts +0 -115
  1484. package/analyzer-template/process/INTEGRATION_COMPLETE.md +0 -333
  1485. package/analyzer-template/process/INTEGRATION_EXAMPLE.md +0 -525
  1486. package/analyzer-template/process/README.md +0 -507
  1487. package/background/src/lib/process/GlobalProcessManager.js.map +0 -1
  1488. package/background/src/lib/process/ProcessManager.js.map +0 -1
  1489. package/background/src/lib/process/index.js.map +0 -1
  1490. package/background/src/lib/process/managedExecAsync.js.map +0 -1
  1491. package/codeyam-cli/scripts/fixtures/cal.com/universal-mocks/packages/prisma/index.js +0 -238
  1492. package/codeyam-cli/scripts/fixtures/cal.com/universal-mocks/packages/prisma/index.js.map +0 -1
  1493. package/codeyam-cli/src/commands/detect-universal-mocks.js +0 -118
  1494. package/codeyam-cli/src/commands/detect-universal-mocks.js.map +0 -1
  1495. package/codeyam-cli/src/commands/list.js +0 -31
  1496. package/codeyam-cli/src/commands/list.js.map +0 -1
  1497. package/codeyam-cli/src/commands/webapp-info.js +0 -146
  1498. package/codeyam-cli/src/commands/webapp-info.js.map +0 -1
  1499. package/codeyam-cli/src/utils/universal-mocks.js +0 -152
  1500. package/codeyam-cli/src/utils/universal-mocks.js.map +0 -1
  1501. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-D4htqD-x.js +0 -1
  1502. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeBadge-kykTbcnD.js +0 -1
  1503. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-Catz6XEN.js +0 -1
  1504. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-TlHocYno.js +0 -26
  1505. package/codeyam-cli/src/webserver/build/client/assets/LibraryFunctionPreview-CVMmGuIc.js +0 -3
  1506. package/codeyam-cli/src/webserver/build/client/assets/LogViewer-JkfQ-VaI.js +0 -3
  1507. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-CVZ0H4BL.js +0 -1
  1508. package/codeyam-cli/src/webserver/build/client/assets/SafeScreenshot-BrMAP1nP.js +0 -1
  1509. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-CJhE4cCv.js +0 -5
  1510. package/codeyam-cli/src/webserver/build/client/assets/TruncatedFilePath-C06nsHKY.js +0 -1
  1511. package/codeyam-cli/src/webserver/build/client/assets/_index-faVIcr_i.js +0 -1
  1512. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-CLMa2sgx.js +0 -7
  1513. package/codeyam-cli/src/webserver/build/client/assets/chevron-down-DwYjrK_h.js +0 -1
  1514. package/codeyam-cli/src/webserver/build/client/assets/chunk-WWGJGFF6-CgXbbZRx.js +0 -26
  1515. package/codeyam-cli/src/webserver/build/client/assets/circle-check-B2oHQ-zo.js +0 -1
  1516. package/codeyam-cli/src/webserver/build/client/assets/createLucideIcon-BBYuR56H.js +0 -1
  1517. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-Bj5GHkhb.js +0 -1
  1518. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.edit._scenarioId-eW5z9AyZ.js +0 -5
  1519. package/codeyam-cli/src/webserver/build/client/assets/entry.client-B9tSboXM.js +0 -5
  1520. package/codeyam-cli/src/webserver/build/client/assets/fileTableUtils-CmO-EZAB.js +0 -1
  1521. package/codeyam-cli/src/webserver/build/client/assets/files-DLinnTOx.js +0 -1
  1522. package/codeyam-cli/src/webserver/build/client/assets/git-CIxwBQvb.js +0 -12
  1523. package/codeyam-cli/src/webserver/build/client/assets/globals-xPz593l2.css +0 -1
  1524. package/codeyam-cli/src/webserver/build/client/assets/html2canvas-pro.esm-XQCGvadH.js +0 -5
  1525. package/codeyam-cli/src/webserver/build/client/assets/index-_LjBsTxX.js +0 -8
  1526. package/codeyam-cli/src/webserver/build/client/assets/loader-circle-D_EGChhq.js +0 -1
  1527. package/codeyam-cli/src/webserver/build/client/assets/manifest-ca438c41.js +0 -1
  1528. package/codeyam-cli/src/webserver/build/client/assets/root-CHHYHuzL.js +0 -16
  1529. package/codeyam-cli/src/webserver/build/client/assets/search-DY8yoDpH.js +0 -1
  1530. package/codeyam-cli/src/webserver/build/client/assets/server-build-CMKNK2uU.css +0 -1
  1531. package/codeyam-cli/src/webserver/build/client/assets/settings-BT6wVHd5.js +0 -1
  1532. package/codeyam-cli/src/webserver/build/client/assets/simulations-gv3H7JV7.js +0 -1
  1533. package/codeyam-cli/src/webserver/build/client/assets/triangle-alert-BthANBVv.js +0 -1
  1534. package/codeyam-cli/src/webserver/build/client/assets/useLastLogLine-Blr5oZDE.js +0 -2
  1535. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-CANr3QJ5.js +0 -1
  1536. package/codeyam-cli/src/webserver/build/client/assets/useToast-Bbf4Hokd.js +0 -1
  1537. package/codeyam-cli/src/webserver/build/server/assets/index-BtBPtyHx.js +0 -1
  1538. package/codeyam-cli/src/webserver/build/server/assets/server-build-N2cTnejq.js +0 -166
  1539. package/codeyam-cli/templates/codeyam-stop-hook.sh +0 -284
  1540. package/codeyam-cli/templates/debug-command.md +0 -141
  1541. package/packages/ai/src/lib/findMatchingAttribute.js +0 -77
  1542. package/packages/ai/src/lib/findMatchingAttribute.js.map +0 -1
  1543. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js +0 -136
  1544. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js.map +0 -1
  1545. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js +0 -220
  1546. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js.map +0 -1
  1547. package/packages/ai/src/lib/generateEntityKeyAttributes.js +0 -241
  1548. package/packages/ai/src/lib/generateEntityKeyAttributes.js.map +0 -1
  1549. package/packages/ai/src/lib/isFrontend.js +0 -5
  1550. package/packages/ai/src/lib/isFrontend.js.map +0 -1
  1551. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js +0 -40
  1552. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js.map +0 -1
  1553. package/packages/ai/src/lib/transformMockDataToMatchSchema.js +0 -124
  1554. package/packages/ai/src/lib/transformMockDataToMatchSchema.js.map +0 -1
  1555. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js +0 -72
  1556. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js.map +0 -1
  1557. package/scripts/finalize-analyzer.cjs +0 -79
  1558. /package/analyzer-template/{process → packages/process/src}/GlobalProcessManager.ts +0 -0
  1559. /package/analyzer-template/{process → packages/process/src}/ProcessManager.ts +0 -0
  1560. /package/analyzer-template/{process → packages/process/src}/index.ts +0 -0
  1561. /package/analyzer-template/{process → packages/process/src}/managedExecAsync.ts +0 -0
  1562. /package/codeyam-cli/src/webserver/build/client/assets/{InteractivePreview-CMKNK2uU.css → styles-CMKNK2uU.css} +0 -0
  1563. /package/{background/src/lib/process → packages/process/src}/GlobalProcessManager.js +0 -0
  1564. /package/{background/src/lib/process → packages/process/src}/index.js +0 -0
  1565. /package/{background/src/lib/process → packages/process/src}/managedExecAsync.js +0 -0
@@ -82,21 +82,36 @@
82
82
  import { ScopeAnalysis } from '~codeyam/types';
83
83
  import { EquivalencyManager } from './equivalencyManagers/EquivalencyManager';
84
84
  import fillInSchemaGapsAndUnknowns from './helpers/fillInSchemaGapsAndUnknowns';
85
+ import { clearCleanKnownObjectFunctionsCache } from './helpers/cleanKnownObjectFunctions';
86
+ import { clearCleanNonObjectFunctionsCache } from './helpers/cleanNonObjectFunctions';
87
+
88
+ /**
89
+ * Patterns that indicate recursive type structures in schema paths.
90
+ * Used by hasExcessivePatternRepetition() to detect exponential path blowup.
91
+ */
92
+ const RECURSIVE_PATH_PATTERNS = [
93
+ /\.attributes\.properties\[\]/g, // TypeScript AST JSX nodes
94
+ /\.children\[\]/g, // Tree structures
95
+ /\.elements\[\]/g, // Array-like structures
96
+ /\.members\[\]/g, // Class/interface members
97
+ /\.properties\[\]/g, // Object properties
98
+ /\.items\[\]/g, // Generic items arrays
99
+ ];
85
100
  import ensureSchemaConsistency from './helpers/ensureSchemaConsistency';
86
101
  import cleanPath from './helpers/cleanPath';
87
102
  import { PathManager } from './helpers/PathManager';
88
103
  import {
89
104
  uniqueId,
90
- uniqueScopeVariables,
91
105
  uniqueScopeAndPaths,
106
+ uniqueScopeVariables,
92
107
  } from './helpers/uniqueIdUtils';
93
108
  import selectBestValue from './helpers/selectBestValue';
94
109
  import { VisitedTracker } from './helpers/VisitedTracker';
95
110
  import { DebugTracer } from './helpers/DebugTracer';
96
111
  import { BatchSchemaProcessor } from './helpers/BatchSchemaProcessor';
97
112
  import {
98
- ScopeTreeManager,
99
113
  ROOT_SCOPE_NAME,
114
+ ScopeTreeManager,
100
115
  ScopeTreeNode,
101
116
  } from './helpers/ScopeTreeManager';
102
117
  import cleanScopeNodeName from './helpers/cleanScopeNodeName';
@@ -108,6 +123,7 @@ import type {
108
123
  SerializableFunctionCallInfo,
109
124
  SerializableFunctionResult,
110
125
  SerializableScopeVariable,
126
+ EnrichedConditionalUsage,
111
127
  } from '../worker/SerializableDataStructure';
112
128
 
113
129
  /**
@@ -125,6 +141,21 @@ export interface ScopeInfo {
125
141
  isStatic?: boolean;
126
142
  isClassScope?: boolean;
127
143
  analysis?: any;
144
+ /** For JSX child scopes, the original JSX tag name (e.g., 'ChildViewer') */
145
+ jsxTagName?: string;
146
+ /**
147
+ * Gating conditions detected during JSX extraction (before JSX is simplified).
148
+ * Maps child component name to conditions that must be true for it to render.
149
+ * This is populated by processJSXForScope in isolateScopes.ts.
150
+ */
151
+ extractedGatingConditions?: {
152
+ [childComponentName: string]: Array<{
153
+ path: string;
154
+ conditionType: 'truthiness' | 'comparison';
155
+ location: 'if' | 'ternary' | 'logical-and' | 'switch' | 'unconditional';
156
+ isNegated?: boolean;
157
+ }>;
158
+ };
128
159
  }
129
160
 
130
161
  /**
@@ -221,6 +252,22 @@ export interface FunctionCallInfo {
221
252
  * For example: { "db.select(query1)": "result1", "db.select(query2)": "result2" }
222
253
  */
223
254
  callSignatureToVariable?: Record<string, string>;
255
+ /**
256
+ * Stores individual schemas per call signature BEFORE merging.
257
+ * When multiple calls to the same function are merged into one FunctionCallInfo,
258
+ * this preserves each call's distinct schema.
259
+ * Key is the call signature (e.g., "useFetcher()").
260
+ * Used internally; converted to perVariableSchemas in toSerializable().
261
+ */
262
+ perCallSignatureSchemas?: Record<string, Record<string, string>>;
263
+ /**
264
+ * Stores individual return value schemas per receiving variable, BEFORE merging.
265
+ * When multiple calls to the same function have different return types
266
+ * (e.g., useFetcher<UserData>() vs useFetcher<ReportData>()), this preserves
267
+ * each call's distinct schema for mock data generation.
268
+ * Key is the receiving variable name (e.g., "userFetcher", "reportFetcher").
269
+ */
270
+ perVariableSchemas?: Record<string, Record<string, string>>;
224
271
  }
225
272
 
226
273
  /**
@@ -287,6 +334,19 @@ export function resetScopeDataStructureMetrics() {
287
334
  followEquivalenciesEarlyExitPhase1Count = 0;
288
335
  followEquivalenciesWithWorkCount = 0;
289
336
  addEquivalencyCallCount = 0;
337
+
338
+ // Clear module-level caches to prevent unbounded memory growth across entities
339
+ const knownObjectCache = clearCleanKnownObjectFunctionsCache();
340
+ const nonObjectCache = clearCleanNonObjectFunctionsCache();
341
+ if (knownObjectCache.count > 0 || nonObjectCache.count > 0) {
342
+ const totalBytes =
343
+ knownObjectCache.estimatedBytes + nonObjectCache.estimatedBytes;
344
+ console.log('CodeYam: Cleared analysis caches', {
345
+ knownObjectCache: `${knownObjectCache.count} entries, ${(knownObjectCache.estimatedBytes / 1024).toFixed(1)}KB`,
346
+ nonObjectCache: `${nonObjectCache.count} entries, ${(nonObjectCache.estimatedBytes / 1024).toFixed(1)}KB`,
347
+ totalKB: `${(totalBytes / 1024).toFixed(1)}KB`,
348
+ });
349
+ }
290
350
  }
291
351
 
292
352
  // Performance: Pre-computed Sets for equivalency reason filtering (O(1) vs O(n))
@@ -320,6 +380,10 @@ const ALLOWED_EQUIVALENCY_REASONS = new Set([
320
380
  'propagated function call return sub-property equivalency',
321
381
  'propagated parent-variable equivalency', // Added: propagate child scope equivalencies to parent scope when variable is defined in parent
322
382
  'where was this function called from', // Added: tracks which scope called an external function
383
+ 'MUI DataGrid renderCell params.row equivalency', // Added: links DataGrid renderCell params.row to rows array elements
384
+ 'MUI Autocomplete getOptionLabel option equivalency', // Added: links Autocomplete getOptionLabel callback param to options array
385
+ 'MUI Autocomplete renderOption option equivalency', // Added: links Autocomplete renderOption callback param to options array
386
+ 'MUI Autocomplete option property equivalency', // Added: propagates property accesses from Autocomplete callbacks
323
387
  ]);
324
388
 
325
389
  const SILENTLY_IGNORED_EQUIVALENCY_REASONS = new Set([
@@ -333,6 +397,8 @@ const SILENTLY_IGNORED_EQUIVALENCY_REASONS = new Set([
333
397
  'transformed non-object function equivalency - implicit parent equivalency - rerouted via useCallback',
334
398
  'transformed non-object function equivalency - Array.from() equivalency',
335
399
  'Spread operator equivalency key update: Explicit array deconstruction equivalency value',
400
+ // 'transformed non-object function equivalency - Explicit array deconstruction equivalency value',
401
+ 'useState setter call equivalency (direct)',
336
402
  ]);
337
403
 
338
404
  export class ScopeDataStructure {
@@ -360,10 +426,40 @@ export class ScopeDataStructure {
360
426
  path: string;
361
427
  conditionType: 'truthiness' | 'comparison' | 'switch';
362
428
  comparedValues?: string[];
363
- location: 'if' | 'ternary' | 'logical-and' | 'switch';
429
+ location: 'if' | 'ternary' | 'logical-and' | 'switch' | 'unconditional';
364
430
  }>
365
431
  > = {};
366
432
 
433
+ /**
434
+ * Conditional effects collected during AST analysis.
435
+ * Tracks what setter calls happen inside conditionals (if, switch, ternary).
436
+ */
437
+ private rawConditionalEffects: import('../astScopes/types').ConditionalEffect[] =
438
+ [];
439
+
440
+ /**
441
+ * Compound conditionals collected during AST analysis.
442
+ * Groups conditions that must all be true together (e.g., a && b && c).
443
+ */
444
+ private rawCompoundConditionals: import('../astScopes/types').CompoundConditional[] =
445
+ [];
446
+
447
+ /**
448
+ * Gating conditions for child component boundaries.
449
+ * Maps child component name to the conditions that must be true for it to render.
450
+ */
451
+ private rawChildBoundaryGatingConditions: Record<
452
+ string,
453
+ import('../astScopes/types').ConditionalUsage[]
454
+ > = {};
455
+
456
+ /**
457
+ * JSX rendering usages collected during AST analysis.
458
+ * Tracks arrays rendered via .map() and strings interpolated in JSX.
459
+ */
460
+ private rawJsxRenderingUsages: import('../astScopes/types').JsxRenderingUsage[] =
461
+ [];
462
+
367
463
  private lastAddToSchemaId = 0;
368
464
  private lastEquivalencyId = 0;
369
465
  private lastEquivalencyDatabaseId = 0;
@@ -382,6 +478,10 @@ export class ScopeDataStructure {
382
478
  private externalFunctionCallsIndex: Map<string, FunctionCallInfo> | null =
383
479
  null;
384
480
 
481
+ // Tracks internal functions that have been filtered out during captureCompleteSchema
482
+ // Prevents re-adding them via subsequent equivalency propagation (e.g., from getReturnValue)
483
+ private filteredInternalFunctions: Set<string> = new Set();
484
+
385
485
  // Debug tracer for selective path/scope tracing
386
486
  // Enable via: CODEYAM_DEBUG=true CODEYAM_DEBUG_PATHS="user.*,signature" npm test
387
487
  private tracer: DebugTracer = new DebugTracer({
@@ -540,6 +640,8 @@ export class ScopeDataStructure {
540
640
  const efcName = this.pathManager.stripGenerics(efc.name);
541
641
  for (const manager of this.equivalencyManagers) {
542
642
  if (manager.internalFunctions.has(efcName)) {
643
+ // Track this so we don't re-add it via subsequent finalize calls
644
+ this.filteredInternalFunctions.add(efcName);
543
645
  return false;
544
646
  }
545
647
  }
@@ -567,13 +669,51 @@ export class ScopeDataStructure {
567
669
  const baseName = this.pathManager.stripGenerics(
568
670
  candidate.scopeNodeName,
569
671
  );
672
+ // Check if this is a local variable path (doesn't contain function call pattern)
673
+ // Local variables like "surveys[]" or "items[]" are important for tracing data flow
674
+ // from parent to child components (e.g., surveys[] -> SurveyCard().signature[0].survey)
675
+ const isLocalVariablePath =
676
+ !candidate.schemaPath.includes('()') &&
677
+ !candidate.schemaPath.startsWith('signature[') &&
678
+ !candidate.schemaPath.startsWith('returnValue');
679
+
570
680
  return (
571
681
  validExternalFacingScopeNames.has(baseName) &&
572
682
  (candidate.schemaPath.startsWith('signature[') ||
573
- candidate.schemaPath.startsWith(baseName)) &&
683
+ candidate.schemaPath.startsWith(baseName) ||
684
+ isLocalVariablePath) &&
574
685
  !containsArrayMethod(candidate.schemaPath)
575
686
  );
576
687
  });
688
+
689
+ // If all sourceCandidates were filtered out (e.g., because they belonged to
690
+ // internal functions like useState), look for the highest-order intermediate
691
+ // that belongs to a valid external-facing scope
692
+ if (
693
+ entry.sourceCandidates.length === 0 &&
694
+ Object.keys(entry.intermediatesOrder).length > 0
695
+ ) {
696
+ // Find intermediates that belong to valid external-facing scopes
697
+ const validIntermediates = Object.entries(entry.intermediatesOrder)
698
+ .filter(([pathId]) => {
699
+ const [scopeNodeName, schemaPath] = pathId.split('::');
700
+ if (!scopeNodeName || !schemaPath) return false;
701
+ const baseName = this.pathManager.stripGenerics(scopeNodeName);
702
+ return (
703
+ validExternalFacingScopeNames.has(baseName) &&
704
+ !containsArrayMethod(schemaPath)
705
+ );
706
+ })
707
+ .sort((a, b) => b[1] - a[1]); // Sort by order descending (highest first)
708
+
709
+ if (validIntermediates.length > 0) {
710
+ const [pathId] = validIntermediates[0];
711
+ const [scopeNodeName, schemaPath] = pathId.split('::');
712
+ if (scopeNodeName && schemaPath) {
713
+ entry.sourceCandidates.push({ scopeNodeName, schemaPath });
714
+ }
715
+ }
716
+ }
577
717
  }
578
718
 
579
719
  this.propagateSourceAndUsageEquivalencies(
@@ -661,6 +801,11 @@ export class ScopeDataStructure {
661
801
  return;
662
802
  }
663
803
 
804
+ // PERF: Early exit for paths with repeated function-call signature patterns
805
+ if (this.hasExcessivePatternRepetition(path)) {
806
+ return;
807
+ }
808
+
664
809
  // Update chain metadata for database tracking
665
810
  if (equivalencyValueChain.length > 0) {
666
811
  equivalencyValueChain[equivalencyValueChain.length - 1].addToSchemaId =
@@ -904,9 +1049,38 @@ export class ScopeDataStructure {
904
1049
  equivalencyValueChain?: EquivalencyValueChainItem[],
905
1050
  traceId?: number,
906
1051
  ) {
907
- // DEBUG: Detect infinite loops
1052
+ // Fast early exits that don't count toward the limit.
1053
+ // These are "no-op" calls that would be caught further below anyway,
1054
+ // but checking them first prevents counter inflation from redundant calls
1055
+ // generated by managers and followEquivalencies during scope processing.
1056
+
1057
+ // Skip silently-ignored reasons before counting
1058
+ if (SILENTLY_IGNORED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
1059
+ return;
1060
+ }
1061
+
1062
+ // Skip exact duplicates before counting (Phase 1 only — Phase 2 needs
1063
+ // to process duplicates for database chain tracking)
1064
+ if (this.onlyEquivalencies) {
1065
+ const existing = scopeNode.equivalencies[path];
1066
+ if (
1067
+ existing?.some(
1068
+ (v) =>
1069
+ v.schemaPath === equivalentPath &&
1070
+ v.scopeNodeName === equivalentScopeName,
1071
+ )
1072
+ ) {
1073
+ return;
1074
+ }
1075
+ }
1076
+
908
1077
  addEquivalencyCallCount++;
909
- if (addEquivalencyCallCount > 50000) {
1078
+
1079
+ const limit =
1080
+ typeof (globalThis as any).__CODEYAM_EQUIVALENCY_LIMIT === 'number'
1081
+ ? (globalThis as any).__CODEYAM_EQUIVALENCY_LIMIT
1082
+ : 50000;
1083
+ if (addEquivalencyCallCount > limit) {
910
1084
  console.error('INFINITE LOOP DETECTED in addEquivalency', {
911
1085
  callCount: addEquivalencyCallCount,
912
1086
  path,
@@ -921,14 +1095,11 @@ export class ScopeDataStructure {
921
1095
  }
922
1096
  // Filter equivalency reasons - use pre-computed Sets for O(1) lookup
923
1097
  if (!ALLOWED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
924
- if (SILENTLY_IGNORED_EQUIVALENCY_REASONS.has(equivalencyReason)) {
925
- return;
926
- } else {
927
- // Log and skip - if an equivalency reason isn't in ALLOWED or SILENTLY_IGNORED,
928
- // it shouldn't be stored (was previously missing the return)
929
- console.info('Not tracked equivalency reason', { equivalencyReason });
930
- return;
931
- }
1098
+ // Silently-ignored reasons already handled above
1099
+ // Log and skip - if an equivalency reason isn't in ALLOWED or SILENTLY_IGNORED,
1100
+ // it shouldn't be stored (was previously missing the return)
1101
+ console.info('Not tracked equivalency reason', { equivalencyReason });
1102
+ return;
932
1103
  }
933
1104
 
934
1105
  // Skip self-referential equivalencies that would create infinite loops.
@@ -964,13 +1135,63 @@ export class ScopeDataStructure {
964
1135
  return;
965
1136
  }
966
1137
 
1138
+ // Case 3: Circular reference through scope-suffixed names (____cyScope pattern)
1139
+ // When a named arrow function is defined inside a scope (e.g., useEffect callback):
1140
+ // const identifyUser = async () => { ... };
1141
+ // identifyUser();
1142
+ // This creates a variable "identifyUser" and a scope "identifyUser____cyScope9F".
1143
+ // Mutual equivalencies between these cause infinite loops in Phase 2 because
1144
+ // processing one triggers addToSchema → followEquivalencies → addEquivalency
1145
+ // on the reverse, which repeats indefinitely.
1146
+ // Only block when the REVERSE direction already exists (creating a cycle).
1147
+ // The initial one-directional equivalency is necessary for scope resolution.
1148
+ if (
1149
+ path &&
1150
+ equivalentPath &&
1151
+ (equivalentPath.startsWith(path + '____') ||
1152
+ path.startsWith(equivalentPath + '____'))
1153
+ ) {
1154
+ // Check if the reverse equivalency already exists
1155
+ const reverseEquivalencies =
1156
+ scopeNode.equivalencies[equivalentPath] || [];
1157
+ const reverseExists = reverseEquivalencies.some(
1158
+ (v) => v.schemaPath === path,
1159
+ );
1160
+ if (reverseExists) {
1161
+ return;
1162
+ }
1163
+ }
1164
+
967
1165
  if (!equivalentScopeName) {
968
- console.warn('Debug Propagation: missing equivalent scope name', {
969
- path,
970
- equivalentPath,
971
- equivalentScopeName,
972
- scopeNodeName: scopeNode.name,
973
- });
1166
+ console.error(
1167
+ 'CodeYam Error: Missing equivalent scope name - FULL CONTEXT:',
1168
+ JSON.stringify(
1169
+ {
1170
+ path,
1171
+ equivalentPath,
1172
+ equivalentScopeName,
1173
+ scopeNodeName: scopeNode.name,
1174
+ equivalencyReason,
1175
+ tree: scopeNode.tree,
1176
+ equivalencyValueChain: equivalencyValueChain?.map((ev) => ({
1177
+ id: ev.id,
1178
+ source: ev.source,
1179
+ reason: ev.reason,
1180
+ currentPath: ev.currentPath,
1181
+ previousPath: ev.previousPath,
1182
+ })),
1183
+ scopeNodeFunctionCalls: scopeNode.functionCalls?.map((fc) => ({
1184
+ name: fc.name,
1185
+ callSignature: fc.callSignature,
1186
+ callScope: fc.callScope,
1187
+ })),
1188
+ instantiatedVariables: scopeNode.instantiatedVariables,
1189
+ parentInstantiatedVariables: scopeNode.parentInstantiatedVariables,
1190
+ },
1191
+ null,
1192
+ 2,
1193
+ ),
1194
+ );
974
1195
  throw new Error('CodeYam Error: Missing equivalent scope name');
975
1196
  }
976
1197
 
@@ -1128,10 +1349,38 @@ export class ScopeDataStructure {
1128
1349
  const existingFunctionCall =
1129
1350
  this.getExternalFunctionCallsIndex().get(searchKey);
1130
1351
  if (existingFunctionCall) {
1131
- existingFunctionCall.schema = {
1352
+ // Preserve per-call schemas BEFORE merging to enable per-variable mock data.
1353
+ // This is critical for hooks like useFetcher<UserData>() vs useFetcher<ReportData>()
1354
+ // where each call returns different typed data.
1355
+ if (!existingFunctionCall.perCallSignatureSchemas) {
1356
+ // First merge - save the existing call's schema
1357
+ existingFunctionCall.perCallSignatureSchemas = {
1358
+ [existingFunctionCall.callSignature]: {
1359
+ ...existingFunctionCall.schema,
1360
+ },
1361
+ };
1362
+ }
1363
+ // Save the new call's schema before it gets merged
1364
+ existingFunctionCall.perCallSignatureSchemas[
1365
+ functionCallInfo.callSignature
1366
+ ] = { ...functionCallInfo.schema };
1367
+
1368
+ // Merge schemas using selectBestValue to preserve specific types like 'null'
1369
+ // over generic types like 'unknown'. This ensures ref variables detected
1370
+ // earlier (marked as 'null') aren't overwritten by later 'unknown' values.
1371
+ const mergedSchema: Record<string, string> = {
1132
1372
  ...existingFunctionCall.schema,
1133
- ...functionCallInfo.schema,
1134
1373
  };
1374
+ for (const key in functionCallInfo.schema) {
1375
+ const existingValue = existingFunctionCall.schema[key];
1376
+ const newValue = functionCallInfo.schema[key];
1377
+ mergedSchema[key] = selectBestValue(
1378
+ existingValue,
1379
+ newValue,
1380
+ newValue,
1381
+ );
1382
+ }
1383
+ existingFunctionCall.schema = mergedSchema;
1135
1384
 
1136
1385
  existingFunctionCall.equivalencies = {
1137
1386
  ...existingFunctionCall.equivalencies,
@@ -1164,8 +1413,15 @@ export class ScopeDataStructure {
1164
1413
  );
1165
1414
 
1166
1415
  if (isExternal) {
1167
- this.externalFunctionCalls.push(functionCallInfo);
1168
- this.invalidateExternalFunctionCallsIndex();
1416
+ // Check if this function was already filtered out as an internal function
1417
+ // (e.g., useState was filtered in captureCompleteSchema but finalize is trying to re-add it)
1418
+ const strippedName = this.pathManager.stripGenerics(
1419
+ functionCallInfo.name,
1420
+ );
1421
+ if (!this.filteredInternalFunctions.has(strippedName)) {
1422
+ this.externalFunctionCalls.push(functionCallInfo);
1423
+ this.invalidateExternalFunctionCallsIndex();
1424
+ }
1169
1425
  }
1170
1426
  }
1171
1427
  }
@@ -1273,11 +1529,32 @@ export class ScopeDataStructure {
1273
1529
  const equivalentSchemaPath = equivalentSchemaPathMap.get(remainingKey);
1274
1530
 
1275
1531
  if (equivalentSchemaPath) {
1532
+ // Skip propagation when there's a structural mismatch:
1533
+ // - schemaPath ends with [] (array element, represents an object)
1534
+ // - equivalentSchemaPath doesn't end with [] (non-array prop, usually a scalar)
1535
+ // This prevents incorrectly typing array elements as strings when they're
1536
+ // equivalent to scalar props like JSX keys (e.g., workouts[] ↔ Card().key)
1537
+ const schemaPathEndsWithArray = schemaPath.endsWith('[]');
1538
+ const equivalentEndsWithArray = equivalentSchemaPath.endsWith('[]');
1539
+ if (schemaPathEndsWithArray !== equivalentEndsWithArray) {
1540
+ // Don't propagate between array element paths and non-array paths
1541
+ continue;
1542
+ }
1543
+
1276
1544
  const value1 = scopeNode.schema[schemaPath];
1277
1545
  const value2 = equivalentScopeNode.schema[equivalentSchemaPath];
1278
1546
 
1279
1547
  const bestValue = selectBestValue(value1, value2);
1280
1548
 
1549
+ // PERF: Skip paths with repeated function-call signature patterns
1550
+ // to prevent recursive type expansion (e.g., string.localeCompare returns string)
1551
+ if (
1552
+ this.hasExcessivePatternRepetition(schemaPath) ||
1553
+ this.hasExcessivePatternRepetition(equivalentSchemaPath)
1554
+ ) {
1555
+ continue;
1556
+ }
1557
+
1281
1558
  scopeNode.schema[schemaPath] = bestValue;
1282
1559
  equivalentScopeNode.schema[equivalentSchemaPath] = bestValue;
1283
1560
  } else if (
@@ -1291,6 +1568,11 @@ export class ScopeDataStructure {
1291
1568
  ...remainingSchemaPathParts,
1292
1569
  ]);
1293
1570
 
1571
+ // PERF: Skip paths with repeated function-call signature patterns
1572
+ if (this.hasExcessivePatternRepetition(newEquivalentPath)) {
1573
+ continue;
1574
+ }
1575
+
1294
1576
  equivalentScopeNode.schema[newEquivalentPath] =
1295
1577
  scopeNode.schema[schemaPath];
1296
1578
  }
@@ -1381,6 +1663,77 @@ export class ScopeDataStructure {
1381
1663
  return this.pathManager.isValidPath(path);
1382
1664
  }
1383
1665
 
1666
+ /**
1667
+ * Detects if a path contains excessive repetition of the same pattern.
1668
+ *
1669
+ * This prevents exponential blowup when analyzing recursive type structures.
1670
+ * For example, TypeScript AST nodes have `.attributes.properties[]` where each
1671
+ * property is also a node with `.attributes.properties[]`. Without this check,
1672
+ * paths like `signature[0].attributes.properties[].attributes.properties[].attributes.properties[]...`
1673
+ * would be generated exponentially.
1674
+ *
1675
+ * Two detection strategies:
1676
+ * 1. Known patterns: Check RECURSIVE_PATH_PATTERNS for common recursive structures
1677
+ * 2. Generic detection: For longer paths, detect any 2-3 part segment that repeats
1678
+ *
1679
+ * @param path - The schema path to check
1680
+ * @param maxRepetitions - Maximum allowed repetitions of any pattern (default: 2)
1681
+ * @returns true if the path has excessive repetition
1682
+ */
1683
+ private hasExcessivePatternRepetition(
1684
+ path: string,
1685
+ maxRepetitions = 2,
1686
+ ): boolean {
1687
+ // Check known recursive patterns
1688
+ for (const pattern of RECURSIVE_PATH_PATTERNS) {
1689
+ const matches = path.match(pattern);
1690
+ if (matches && matches.length > maxRepetitions) {
1691
+ return true;
1692
+ }
1693
+ }
1694
+
1695
+ // Check for repeated function calls that indicate recursive type expansion.
1696
+ // E.g., localeCompare(b[])...localeCompare(b[]) means string.localeCompare
1697
+ // returns a type that again has localeCompare, causing infinite expansion.
1698
+ // We extract all function call patterns like "funcName(args)" and check if
1699
+ // the same normalized call appears more than once.
1700
+ const funcCallPattern = /(?:^|\.)[^.([]+\([^)]*\)/g;
1701
+ const funcCallMatches = path.match(funcCallPattern);
1702
+ if (funcCallMatches && funcCallMatches.length > 1) {
1703
+ const seen = new Set<string>();
1704
+ for (const match of funcCallMatches) {
1705
+ // Strip leading dot and normalize array indices
1706
+ const normalized = match.replace(/^\./, '').replace(/\[\d+\]/g, '[]');
1707
+ if (seen.has(normalized)) return true;
1708
+ seen.add(normalized);
1709
+ }
1710
+ }
1711
+
1712
+ // For longer paths, detect any repeated multi-part segments we haven't explicitly listed
1713
+ const pathParts = this.splitPath(path);
1714
+ if (pathParts.length <= 6) {
1715
+ return false;
1716
+ }
1717
+
1718
+ // Check for repeated sequences of 2-3 consecutive parts
1719
+ for (let segmentLength = 2; segmentLength <= 3; segmentLength++) {
1720
+ const seen = new Map<string, number>();
1721
+
1722
+ for (let i = 0; i <= pathParts.length - segmentLength; i++) {
1723
+ const segment = pathParts.slice(i, i + segmentLength).join('.');
1724
+ const normalizedSegment = segment.replace(/\[\d+\]/g, '[]');
1725
+ const count = (seen.get(normalizedSegment) || 0) + 1;
1726
+ seen.set(normalizedSegment, count);
1727
+
1728
+ if (count > maxRepetitions) {
1729
+ return true;
1730
+ }
1731
+ }
1732
+ }
1733
+
1734
+ return false;
1735
+ }
1736
+
1384
1737
  private addToTree(pathParts: string[]) {
1385
1738
  this.scopeTreeManager.addPath(pathParts);
1386
1739
  }
@@ -1388,17 +1741,26 @@ export class ScopeDataStructure {
1388
1741
  private setInstantiatedVariables(scopeNode: ScopeNode) {
1389
1742
  let instantiatedVariables = scopeNode.analysis?.instantiatedVariables ?? [];
1390
1743
 
1391
- for (const [path, equivalentPath] of Object.entries(
1744
+ for (const [path, rawEquivalentPath] of Object.entries(
1392
1745
  scopeNode.analysis.isolatedEquivalentVariables ?? {},
1393
1746
  )) {
1394
- if (typeof equivalentPath !== 'string') {
1395
- continue;
1396
- }
1747
+ // Normalize to array for consistent handling (supports both string and string[])
1748
+ const equivalentPaths = Array.isArray(rawEquivalentPath)
1749
+ ? rawEquivalentPath
1750
+ : rawEquivalentPath
1751
+ ? [rawEquivalentPath]
1752
+ : [];
1753
+
1754
+ for (const equivalentPath of equivalentPaths) {
1755
+ if (typeof equivalentPath !== 'string') {
1756
+ continue;
1757
+ }
1397
1758
 
1398
- if (equivalentPath.startsWith('signature[')) {
1399
- const equivalentPathParts = this.splitPath(equivalentPath);
1400
- instantiatedVariables.push(equivalentPathParts[0]);
1401
- instantiatedVariables.push(path);
1759
+ if (equivalentPath.startsWith('signature[')) {
1760
+ const equivalentPathParts = this.splitPath(equivalentPath);
1761
+ instantiatedVariables.push(equivalentPathParts[0]);
1762
+ instantiatedVariables.push(path);
1763
+ }
1402
1764
  }
1403
1765
 
1404
1766
  const duplicateInstantiated = instantiatedVariables.find(
@@ -1411,9 +1773,14 @@ export class ScopeDataStructure {
1411
1773
  }
1412
1774
  }
1413
1775
 
1414
- instantiatedVariables = instantiatedVariables.filter(
1415
- (varName, index, self) => self.indexOf(varName) === index,
1416
- );
1776
+ const instantiatedSeen = new Set<string>();
1777
+ instantiatedVariables = instantiatedVariables.filter((varName) => {
1778
+ if (instantiatedSeen.has(varName)) {
1779
+ return false;
1780
+ }
1781
+ instantiatedSeen.add(varName);
1782
+ return true;
1783
+ });
1417
1784
 
1418
1785
  scopeNode.instantiatedVariables = instantiatedVariables;
1419
1786
 
@@ -1434,13 +1801,19 @@ export class ScopeDataStructure {
1434
1801
  ...parentScopeNode.instantiatedVariables.filter(
1435
1802
  (v) => !v.startsWith('signature[') && !v.startsWith('returnValue'),
1436
1803
  ),
1437
- ].filter(
1438
- (varName, index, self) =>
1439
- !instantiatedVariables.includes(varName) &&
1440
- self.indexOf(varName) === index,
1441
- );
1804
+ ].filter((varName) => !instantiatedSeen.has(varName));
1805
+
1806
+ const parentInstantiatedSeen = new Set<string>();
1807
+ const dedupedParentInstantiatedVariables =
1808
+ parentInstantiatedVariables.filter((varName) => {
1809
+ if (parentInstantiatedSeen.has(varName)) {
1810
+ return false;
1811
+ }
1812
+ parentInstantiatedSeen.add(varName);
1813
+ return true;
1814
+ });
1442
1815
 
1443
- scopeNode.parentInstantiatedVariables = parentInstantiatedVariables;
1816
+ scopeNode.parentInstantiatedVariables = dedupedParentInstantiatedVariables;
1444
1817
  }
1445
1818
 
1446
1819
  private trackFunctionCalls(scopeNode: ScopeNode) {
@@ -1449,197 +1822,205 @@ export class ScopeDataStructure {
1449
1822
  }
1450
1823
 
1451
1824
  private determineEquivalenciesAndBuildSchema(scopeNode: ScopeNode) {
1825
+ if (!scopeNode.analysis) {
1826
+ return;
1827
+ }
1828
+
1452
1829
  const { isolatedStructure, isolatedEquivalentVariables } =
1453
1830
  scopeNode.analysis;
1454
1831
 
1455
- // DEBUG: Log all equivalencies related to useFetcher
1456
- if (
1457
- Object.keys(isolatedEquivalentVariables || {}).some(
1458
- (k) => k.includes('Fetcher') || k.includes('fetcher'),
1459
- )
1460
- ) {
1461
- console.log(
1462
- 'CodeYam DEBUG determineEquivalenciesAndBuildSchema:',
1463
- JSON.stringify(
1464
- {
1465
- scopeNodeName: scopeNode.name,
1466
- fetcherEquivalencies: Object.entries(
1467
- isolatedEquivalentVariables || {},
1468
- )
1469
- .filter(
1470
- ([k, v]) =>
1471
- k.includes('Fetcher') ||
1472
- k.includes('fetcher') ||
1473
- String(v).includes('Fetcher') ||
1474
- String(v).includes('fetcher'),
1475
- )
1476
- .reduce(
1477
- (acc, [k, v]) => {
1478
- acc[k] = v;
1479
- return acc;
1480
- },
1481
- {} as Record<string, string>,
1482
- ),
1483
- },
1484
- null,
1485
- 2,
1486
- ),
1487
- );
1488
- }
1832
+ // Flatten isolatedEquivalentVariables values for allPaths (handles both string and string[])
1833
+ const flattenedEquivValues = Object.values(
1834
+ isolatedEquivalentVariables || {},
1835
+ ).flatMap((v) => (Array.isArray(v) ? v : [v]));
1489
1836
 
1490
1837
  const allPaths = Array.from(
1491
1838
  new Set([
1492
1839
  ...Object.keys(isolatedStructure || {}),
1493
1840
  ...Object.keys(isolatedEquivalentVariables || {}),
1494
- ...Object.values(isolatedEquivalentVariables || {}),
1841
+ ...flattenedEquivValues,
1495
1842
  ]),
1496
1843
  );
1497
1844
 
1498
1845
  for (let path in isolatedEquivalentVariables) {
1499
- let equivalentValue = isolatedEquivalentVariables?.[path];
1500
-
1501
- if (equivalentValue && this.isValidPath(equivalentValue)) {
1502
- path = cleanPath(path.replace(/::cyDuplicateKey\d+::/g, ''), allPaths);
1503
- equivalentValue = cleanPath(
1504
- equivalentValue.replace(/::cyDuplicateKey\d+::/g, ''),
1505
- allPaths,
1506
- );
1507
-
1508
- this.addEquivalency(
1509
- path,
1510
- equivalentValue,
1511
- scopeNode.name,
1512
- scopeNode,
1513
- 'original equivalency',
1514
- );
1846
+ const rawEquivalentValue = isolatedEquivalentVariables?.[path];
1847
+ // Normalize to array for consistent handling
1848
+ const equivalentValues = Array.isArray(rawEquivalentValue)
1849
+ ? rawEquivalentValue
1850
+ : [rawEquivalentValue];
1851
+
1852
+ for (let equivalentValue of equivalentValues) {
1853
+ if (equivalentValue && this.isValidPath(equivalentValue)) {
1854
+ // IMPORTANT: DO NOT strip ::cyDuplicateKey:: markers from equivalencies.
1855
+ // These markers are critical for distinguishing variable reassignments.
1856
+ // For example, with:
1857
+ // let fetcher = useFetcher<ConfigData>();
1858
+ // const configData = fetcher.data?.data;
1859
+ // fetcher = useFetcher<SettingsData>();
1860
+ // const settingsData = fetcher.data?.data;
1861
+ //
1862
+ // mergeStatements creates:
1863
+ // fetcher → useFetcher<ConfigData>()...
1864
+ // fetcher::cyDuplicateKey1:: → useFetcher<SettingsData>()...
1865
+ // configData → fetcher.data.data
1866
+ // settingsData → fetcher::cyDuplicateKey1::.data.data
1867
+ //
1868
+ // If we strip ::cyDuplicateKey::, settingsData would incorrectly trace
1869
+ // to useFetcher<ConfigData>() instead of useFetcher<SettingsData>().
1870
+ path = cleanPath(path, allPaths);
1871
+ equivalentValue = cleanPath(equivalentValue, allPaths);
1872
+
1873
+ this.addEquivalency(
1874
+ path,
1875
+ equivalentValue,
1876
+ scopeNode.name,
1877
+ scopeNode,
1878
+ 'original equivalency',
1879
+ );
1515
1880
 
1516
- // Propagate equivalencies involving parent-scope variables to those parent scopes.
1517
- // This handles patterns like: collected.push({...entity}) where 'collected' is defined
1518
- // in a parent scope. The equivalency collected[] -> push().signature[0] needs to be
1519
- // visible when tracing from the parent scope.
1520
- const rootVariable = this.extractRootVariable(path);
1521
- const equivalentRootVariable =
1522
- this.extractRootVariable(equivalentValue);
1523
-
1524
- // Skip propagation for self-referential reassignment patterns like:
1525
- // x = x.method().functionCallReturnValue
1526
- // where the path IS the variable itself (not a sub-path like x[] or x.prop).
1527
- // These create circular references since both sides reference the same variable.
1528
- //
1529
- // But DO propagate for patterns like collected[] -> collected.push(...).signature[0]
1530
- // where the path has additional segments beyond the root variable.
1531
- const pathIsJustRootVariable = path === rootVariable;
1532
- const isSelfReferentialReassignment =
1533
- pathIsJustRootVariable && rootVariable === equivalentRootVariable;
1881
+ // Propagate equivalencies involving parent-scope variables to those parent scopes.
1882
+ // This handles patterns like: collected.push({...entity}) where 'collected' is defined
1883
+ // in a parent scope. The equivalency collected[] -> push().signature[0] needs to be
1884
+ // visible when tracing from the parent scope.
1885
+ const rootVariable = this.extractRootVariable(path);
1886
+ const equivalentRootVariable =
1887
+ this.extractRootVariable(equivalentValue);
1888
+
1889
+ // Skip propagation for self-referential reassignment patterns like:
1890
+ // x = x.method().functionCallReturnValue
1891
+ // where the path IS the variable itself (not a sub-path like x[] or x.prop).
1892
+ // These create circular references since both sides reference the same variable.
1893
+ //
1894
+ // But DO propagate for patterns like collected[] -> collected.push(...).signature[0]
1895
+ // where the path has additional segments beyond the root variable.
1896
+ const pathIsJustRootVariable = path === rootVariable;
1897
+ const isSelfReferentialReassignment =
1898
+ pathIsJustRootVariable && rootVariable === equivalentRootVariable;
1534
1899
 
1535
- if (
1536
- rootVariable &&
1537
- !isSelfReferentialReassignment &&
1538
- scopeNode.parentInstantiatedVariables?.includes(rootVariable)
1539
- ) {
1540
- // Find the parent scope where this variable is defined
1541
- for (const parentScopeName of scopeNode.tree || []) {
1542
- const parentScope = this.scopeNodes[parentScopeName];
1543
- if (parentScope?.instantiatedVariables?.includes(rootVariable)) {
1544
- // Add the equivalency to the parent scope as well
1545
- this.addEquivalency(
1546
- path,
1547
- equivalentValue,
1548
- scopeNode.name, // The equivalent path's scope remains the child scope
1549
- parentScope, // But store it in the parent scope's equivalencies
1550
- 'propagated parent-variable equivalency',
1551
- );
1552
- break;
1900
+ if (
1901
+ rootVariable &&
1902
+ !isSelfReferentialReassignment &&
1903
+ scopeNode.parentInstantiatedVariables?.includes(rootVariable)
1904
+ ) {
1905
+ // Find the parent scope where this variable is defined
1906
+ for (const parentScopeName of scopeNode.tree || []) {
1907
+ const parentScope = this.scopeNodes[parentScopeName];
1908
+ if (parentScope?.instantiatedVariables?.includes(rootVariable)) {
1909
+ // Add the equivalency to the parent scope as well
1910
+ this.addEquivalency(
1911
+ path,
1912
+ equivalentValue,
1913
+ scopeNode.name, // The equivalent path's scope remains the child scope
1914
+ parentScope, // But store it in the parent scope's equivalencies
1915
+ 'propagated parent-variable equivalency',
1916
+ );
1917
+ break;
1918
+ }
1553
1919
  }
1554
1920
  }
1555
- }
1556
1921
 
1557
- // Propagate sub-property equivalencies when the equivalentValue is a simple variable
1558
- // that has sub-properties defined in the isolatedEquivalentVariables.
1559
- // This handles cases like: dataItem={{ structure: completeDataStructure }}
1560
- // where completeDataStructure has sub-properties like completeDataStructure['Function Arguments']
1561
- // We need to propagate these to create: dataItem.structure['Function Arguments'] equivalencies
1562
- const isSimpleVariable =
1563
- !equivalentValue.startsWith('signature[') &&
1564
- !equivalentValue.includes('functionCallReturnValue') &&
1565
- !equivalentValue.includes('.') &&
1566
- !equivalentValue.includes('[');
1567
-
1568
- if (isSimpleVariable) {
1569
- // Look in current scope and all parent scopes for sub-properties
1570
- const scopesToCheck = [scopeNode.name, ...scopeNode.tree];
1571
- for (const scopeName of scopesToCheck) {
1572
- const checkScope = this.scopeNodes[scopeName];
1573
- if (!checkScope?.analysis?.isolatedEquivalentVariables) continue;
1574
-
1575
- for (const [subPath, subValue] of Object.entries(
1576
- checkScope.analysis.isolatedEquivalentVariables,
1577
- )) {
1578
- // Check if this is a sub-property of the equivalentValue variable
1579
- // e.g., completeDataStructure['Function Arguments'] or completeDataStructure.foo
1580
- const matchesDot = subPath.startsWith(equivalentValue + '.');
1581
- const matchesBracket = subPath.startsWith(equivalentValue + '[');
1582
- if (matchesDot || matchesBracket) {
1583
- const subPropertyPath = subPath.substring(
1584
- equivalentValue.length,
1922
+ // Propagate sub-property equivalencies when the equivalentValue is a simple variable
1923
+ // that has sub-properties defined in the isolatedEquivalentVariables.
1924
+ // This handles cases like: dataItem={{ structure: completeDataStructure }}
1925
+ // where completeDataStructure has sub-properties like completeDataStructure['Function Arguments']
1926
+ // We need to propagate these to create: dataItem.structure['Function Arguments'] equivalencies
1927
+ const isSimpleVariable =
1928
+ !equivalentValue.startsWith('signature[') &&
1929
+ !equivalentValue.includes('functionCallReturnValue') &&
1930
+ !equivalentValue.includes('.') &&
1931
+ !equivalentValue.includes('[');
1932
+
1933
+ if (isSimpleVariable) {
1934
+ // Look in current scope and all parent scopes for sub-properties
1935
+ const scopesToCheck = [scopeNode.name, ...scopeNode.tree];
1936
+ for (const scopeName of scopesToCheck) {
1937
+ const checkScope = this.scopeNodes[scopeName];
1938
+ if (!checkScope?.analysis?.isolatedEquivalentVariables) continue;
1939
+
1940
+ for (const [subPath, rawSubValue] of Object.entries(
1941
+ checkScope.analysis.isolatedEquivalentVariables,
1942
+ )) {
1943
+ // Normalize to array for consistent handling
1944
+ const subValues = Array.isArray(rawSubValue)
1945
+ ? rawSubValue
1946
+ : rawSubValue
1947
+ ? [rawSubValue]
1948
+ : [];
1949
+
1950
+ // Check if this is a sub-property of the equivalentValue variable
1951
+ // e.g., completeDataStructure['Function Arguments'] or completeDataStructure.foo
1952
+ const matchesDot = subPath.startsWith(equivalentValue + '.');
1953
+ const matchesBracket = subPath.startsWith(
1954
+ equivalentValue + '[',
1585
1955
  );
1586
- const newPath = cleanPath(path + subPropertyPath, allPaths);
1587
- const newEquivalentValue = cleanPath(
1588
- (subValue as string).replace(/::cyDuplicateKey\d+::/g, ''),
1589
- allPaths,
1590
- );
1591
-
1592
- if (
1593
- newEquivalentValue &&
1594
- this.isValidPath(newEquivalentValue)
1595
- ) {
1596
- this.addEquivalency(
1597
- newPath,
1598
- newEquivalentValue,
1599
- checkScope.name, // Use the scope where the sub-property was found
1600
- scopeNode,
1601
- 'propagated sub-property equivalency',
1956
+ if (matchesDot || matchesBracket) {
1957
+ const subPropertyPath = subPath.substring(
1958
+ equivalentValue.length,
1602
1959
  );
1960
+ const newPath = cleanPath(path + subPropertyPath, allPaths);
1961
+
1962
+ for (const subValue of subValues) {
1963
+ if (typeof subValue !== 'string') continue;
1964
+ const newEquivalentValue = cleanPath(
1965
+ subValue.replace(/::cyDuplicateKey\d+::/g, ''),
1966
+ allPaths,
1967
+ );
1968
+
1969
+ if (
1970
+ newEquivalentValue &&
1971
+ this.isValidPath(newEquivalentValue)
1972
+ ) {
1973
+ this.addEquivalency(
1974
+ newPath,
1975
+ newEquivalentValue,
1976
+ checkScope.name, // Use the scope where the sub-property was found
1977
+ scopeNode,
1978
+ 'propagated sub-property equivalency',
1979
+ );
1980
+ }
1981
+ }
1603
1982
  }
1604
- }
1605
1983
 
1606
- // Also check if equivalentValue itself maps to a functionCallReturnValue
1607
- // e.g., result = useMemo(...).functionCallReturnValue
1608
- if (
1609
- subPath === equivalentValue &&
1610
- typeof subValue === 'string' &&
1611
- subValue.endsWith('.functionCallReturnValue')
1612
- ) {
1613
- this.propagateFunctionCallReturnSubProperties(
1614
- path,
1615
- subValue,
1616
- scopeNode,
1617
- allPaths,
1618
- );
1984
+ // Also check if equivalentValue itself maps to a functionCallReturnValue
1985
+ // e.g., result = useMemo(...).functionCallReturnValue
1986
+ for (const subValue of subValues) {
1987
+ if (
1988
+ subPath === equivalentValue &&
1989
+ typeof subValue === 'string' &&
1990
+ subValue.endsWith('.functionCallReturnValue')
1991
+ ) {
1992
+ this.propagateFunctionCallReturnSubProperties(
1993
+ path,
1994
+ subValue,
1995
+ scopeNode,
1996
+ allPaths,
1997
+ );
1998
+ }
1999
+ }
1619
2000
  }
1620
2001
  }
1621
2002
  }
1622
- }
1623
2003
 
1624
- // Handle function call return values by propagating returnValue.* sub-properties
1625
- // from the callback scope to the usage path
1626
- if (equivalentValue.endsWith('.functionCallReturnValue')) {
1627
- this.propagateFunctionCallReturnSubProperties(
1628
- path,
1629
- equivalentValue,
1630
- scopeNode,
1631
- allPaths,
1632
- );
2004
+ // Handle function call return values by propagating returnValue.* sub-properties
2005
+ // from the callback scope to the usage path
2006
+ if (equivalentValue.endsWith('.functionCallReturnValue')) {
2007
+ this.propagateFunctionCallReturnSubProperties(
2008
+ path,
2009
+ equivalentValue,
2010
+ scopeNode,
2011
+ allPaths,
2012
+ );
1633
2013
 
1634
- // Track which variable receives the return value of each function call
1635
- // This enables generating separate mock data for each call site
1636
- this.trackReceivingVariable(path, equivalentValue);
1637
- }
2014
+ // Track which variable receives the return value of each function call
2015
+ // This enables generating separate mock data for each call site
2016
+ this.trackReceivingVariable(path, equivalentValue);
2017
+ }
1638
2018
 
1639
- // Also track variables that receive destructured properties from function call return values
1640
- // e.g., "userData" -> "db.query('users').functionCallReturnValue.data"
1641
- if (equivalentValue.includes('.functionCallReturnValue.')) {
1642
- this.trackReceivingVariable(path, equivalentValue);
2019
+ // Also track variables that receive destructured properties from function call return values
2020
+ // e.g., "userData" -> "db.query('users').functionCallReturnValue.data"
2021
+ if (equivalentValue.includes('.functionCallReturnValue.')) {
2022
+ this.trackReceivingVariable(path, equivalentValue);
2023
+ }
1643
2024
  }
1644
2025
  }
1645
2026
  }
@@ -1649,7 +2030,7 @@ export class ScopeDataStructure {
1649
2030
  this.batchProcessor = new BatchSchemaProcessor();
1650
2031
  this.batchQueuedSet = new Set();
1651
2032
 
1652
- for (const key of Array.from(allPaths)) {
2033
+ for (const key of allPaths) {
1653
2034
  let value = isolatedStructure[key] ?? 'unknown';
1654
2035
 
1655
2036
  if (['null', 'undefined'].includes(value)) {
@@ -1690,7 +2071,19 @@ export class ScopeDataStructure {
1690
2071
  private processBatchQueue(): void {
1691
2072
  if (!this.batchProcessor) return;
1692
2073
 
2074
+ let iterations = 0;
2075
+
1693
2076
  while (this.batchProcessor.hasWork()) {
2077
+ iterations++;
2078
+
2079
+ // Safety: detect potential infinite loops
2080
+ if (iterations > 100000) {
2081
+ console.error(
2082
+ `[ScopeDataStructure] processBatchQueue exceeded 100k iterations, possible infinite loop!`,
2083
+ );
2084
+ break;
2085
+ }
2086
+
1694
2087
  const item = this.batchProcessor.getNextWork();
1695
2088
  if (!item) break;
1696
2089
 
@@ -1748,26 +2141,6 @@ export class ScopeDataStructure {
1748
2141
  const functionCallInfo =
1749
2142
  this.getExternalFunctionCallsIndex().get(searchKey);
1750
2143
 
1751
- // DEBUG: Track useFetcher calls
1752
- if (searchKey === 'useFetcher' || callSignature.includes('useFetcher')) {
1753
- console.log(
1754
- 'CodeYam DEBUG trackReceivingVariable:',
1755
- JSON.stringify(
1756
- {
1757
- receivingVariable,
1758
- equivalentValue,
1759
- callSignature,
1760
- searchKey,
1761
- foundFunctionCallInfo: !!functionCallInfo,
1762
- existingRecvVars: functionCallInfo?.receivingVariableNames,
1763
- existingCallSigToVar: functionCallInfo?.callSignatureToVariable,
1764
- },
1765
- null,
1766
- 2,
1767
- ),
1768
- );
1769
- }
1770
-
1771
2144
  if (!functionCallInfo) {
1772
2145
  return;
1773
2146
  }
@@ -1828,9 +2201,18 @@ export class ScopeDataStructure {
1828
2201
  const checkScope = this.scopeNodes[scopeName];
1829
2202
  if (!checkScope?.analysis?.isolatedEquivalentVariables) continue;
1830
2203
 
1831
- const functionRef =
2204
+ const rawFunctionRef =
1832
2205
  checkScope.analysis.isolatedEquivalentVariables[functionName];
1833
- if (typeof functionRef === 'string' && functionRef.endsWith('F')) {
2206
+ // Normalize to array and find first string ending with 'F'
2207
+ const functionRefs = Array.isArray(rawFunctionRef)
2208
+ ? rawFunctionRef
2209
+ : rawFunctionRef
2210
+ ? [rawFunctionRef]
2211
+ : [];
2212
+ const functionRef = functionRefs.find(
2213
+ (r) => typeof r === 'string' && r.endsWith('F'),
2214
+ );
2215
+ if (typeof functionRef === 'string') {
1834
2216
  callbackScopeName = functionRef.slice(0, -1);
1835
2217
  break;
1836
2218
  }
@@ -1858,19 +2240,24 @@ export class ScopeDataStructure {
1858
2240
 
1859
2241
  const isolatedVars = callbackScope.analysis.isolatedEquivalentVariables;
1860
2242
 
2243
+ // Get the first returnValue equivalency (normalize array to single value for these checks)
2244
+ const rawReturnValue = isolatedVars.returnValue;
2245
+ const firstReturnValue = Array.isArray(rawReturnValue)
2246
+ ? rawReturnValue[0]
2247
+ : rawReturnValue;
2248
+
1861
2249
  // First, check if returnValue is an alias to another variable (e.g., returnValue = intermediate)
1862
2250
  // If so, we need to look for that variable's sub-properties too
1863
2251
  const returnValueAlias =
1864
- typeof isolatedVars.returnValue === 'string' &&
1865
- !isolatedVars.returnValue.includes('.')
1866
- ? isolatedVars.returnValue
2252
+ typeof firstReturnValue === 'string' && !firstReturnValue.includes('.')
2253
+ ? firstReturnValue
1867
2254
  : undefined;
1868
2255
 
1869
2256
  // Pattern 3: Object.keys(X).reduce() - the reduce result has the same sub-properties as X
1870
2257
  // When returnValue = "Object.keys(source).reduce(...).functionCallReturnValue", look for source.* sub-properties
1871
2258
  let reduceSourceVar: string | undefined;
1872
- if (typeof isolatedVars.returnValue === 'string') {
1873
- const reduceMatch = isolatedVars.returnValue.match(
2259
+ if (typeof firstReturnValue === 'string') {
2260
+ const reduceMatch = firstReturnValue.match(
1874
2261
  /^Object\.keys\((\w+)\)\.reduce\(.*\)\.functionCallReturnValue$/,
1875
2262
  );
1876
2263
  if (reduceMatch) {
@@ -1878,7 +2265,14 @@ export class ScopeDataStructure {
1878
2265
  }
1879
2266
  }
1880
2267
 
1881
- for (const [subPath, subValue] of Object.entries(isolatedVars)) {
2268
+ for (const [subPath, rawSubValue] of Object.entries(isolatedVars)) {
2269
+ // Normalize to array for consistent handling
2270
+ const subValues = Array.isArray(rawSubValue)
2271
+ ? rawSubValue
2272
+ : rawSubValue
2273
+ ? [rawSubValue]
2274
+ : [];
2275
+
1882
2276
  // Check for direct returnValue.* sub-properties
1883
2277
  const isReturnValueSub =
1884
2278
  subPath.startsWith('returnValue.') ||
@@ -1896,59 +2290,61 @@ export class ScopeDataStructure {
1896
2290
  (subPath.startsWith(reduceSourceVar + '.') ||
1897
2291
  subPath.startsWith(reduceSourceVar + '['));
1898
2292
 
1899
- if (
1900
- typeof subValue !== 'string' ||
1901
- (!isReturnValueSub && !isAliasSub && !isReduceSourceSub)
1902
- )
1903
- continue;
2293
+ if (!isReturnValueSub && !isAliasSub && !isReduceSourceSub) continue;
2294
+
2295
+ for (const subValue of subValues) {
2296
+ if (typeof subValue !== 'string') continue;
2297
+
2298
+ // Convert alias/reduceSource paths to returnValue paths
2299
+ let effectiveSubPath = subPath;
2300
+ if (isAliasSub && !isReturnValueSub) {
2301
+ // Replace the alias prefix with returnValue
2302
+ effectiveSubPath =
2303
+ 'returnValue' + subPath.substring(returnValueAlias!.length);
2304
+ } else if (isReduceSourceSub && !isReturnValueSub && !isAliasSub) {
2305
+ // Replace the reduce source prefix with returnValue
2306
+ effectiveSubPath =
2307
+ 'returnValue' + subPath.substring(reduceSourceVar!.length);
2308
+ }
2309
+ const subPropertyPath = effectiveSubPath.substring(
2310
+ 'returnValue'.length,
2311
+ );
2312
+ const newPath = cleanPath(path + subPropertyPath, allPaths);
2313
+ let newEquivalentValue = cleanPath(
2314
+ subValue.replace(/::cyDuplicateKey\d+::/g, ''),
2315
+ allPaths,
2316
+ );
1904
2317
 
1905
- // Convert alias/reduceSource paths to returnValue paths
1906
- let effectiveSubPath = subPath;
1907
- if (isAliasSub && !isReturnValueSub) {
1908
- // Replace the alias prefix with returnValue
1909
- effectiveSubPath =
1910
- 'returnValue' + subPath.substring(returnValueAlias!.length);
1911
- } else if (isReduceSourceSub && !isReturnValueSub && !isAliasSub) {
1912
- // Replace the reduce source prefix with returnValue
1913
- effectiveSubPath =
1914
- 'returnValue' + subPath.substring(reduceSourceVar!.length);
1915
- }
1916
- const subPropertyPath = effectiveSubPath.substring('returnValue'.length);
1917
- const newPath = cleanPath(path + subPropertyPath, allPaths);
1918
- let newEquivalentValue = cleanPath(
1919
- subValue.replace(/::cyDuplicateKey\d+::/g, ''),
1920
- allPaths,
1921
- );
2318
+ // Resolve variable references through parent scope equivalencies
2319
+ const resolved = this.resolveVariableThroughParentScopes(
2320
+ newEquivalentValue,
2321
+ callbackScope,
2322
+ allPaths,
2323
+ );
2324
+ newEquivalentValue = resolved.resolvedPath;
2325
+ const equivalentScopeName = resolved.scopeName;
1922
2326
 
1923
- // Resolve variable references through parent scope equivalencies
1924
- const resolved = this.resolveVariableThroughParentScopes(
1925
- newEquivalentValue,
1926
- callbackScope,
1927
- allPaths,
1928
- );
1929
- newEquivalentValue = resolved.resolvedPath;
1930
- const equivalentScopeName = resolved.scopeName;
2327
+ if (!newEquivalentValue || !this.isValidPath(newEquivalentValue))
2328
+ continue;
1931
2329
 
1932
- if (!newEquivalentValue || !this.isValidPath(newEquivalentValue))
1933
- continue;
2330
+ this.addEquivalency(
2331
+ newPath,
2332
+ newEquivalentValue,
2333
+ equivalentScopeName,
2334
+ scopeNode,
2335
+ 'propagated function call return sub-property equivalency',
2336
+ );
1934
2337
 
1935
- this.addEquivalency(
1936
- newPath,
1937
- newEquivalentValue,
1938
- equivalentScopeName,
1939
- scopeNode,
1940
- 'propagated function call return sub-property equivalency',
1941
- );
1942
-
1943
- // Ensure the database entry has the usage path
1944
- this.addUsageToEquivalencyDatabaseEntry(
1945
- newPath,
1946
- newEquivalentValue,
1947
- equivalentScopeName,
1948
- scopeNode.name,
1949
- );
1950
- }
1951
- }
2338
+ // Ensure the database entry has the usage path
2339
+ this.addUsageToEquivalencyDatabaseEntry(
2340
+ newPath,
2341
+ newEquivalentValue,
2342
+ equivalentScopeName,
2343
+ scopeNode.name,
2344
+ );
2345
+ }
2346
+ }
2347
+ }
1952
2348
 
1953
2349
  /**
1954
2350
  * Resolves a variable path through parent scope equivalencies.
@@ -1986,8 +2382,15 @@ export class ScopeDataStructure {
1986
2382
  const parentScope = this.scopeNodes[parentScopeName];
1987
2383
  if (!parentScope?.analysis?.isolatedEquivalentVariables) continue;
1988
2384
 
1989
- const rootEquiv =
2385
+ const rawRootEquiv =
1990
2386
  parentScope.analysis.isolatedEquivalentVariables[rootVar];
2387
+ // Normalize to array and use first string value
2388
+ const rootEquivs = Array.isArray(rawRootEquiv)
2389
+ ? rawRootEquiv
2390
+ : rawRootEquiv
2391
+ ? [rawRootEquiv]
2392
+ : [];
2393
+ const rootEquiv = rootEquivs.find((r) => typeof r === 'string');
1991
2394
  if (typeof rootEquiv === 'string') {
1992
2395
  return {
1993
2396
  resolvedPath: cleanPath(rootEquiv + restOfPath, allPaths),
@@ -2262,11 +2665,27 @@ export class ScopeDataStructure {
2262
2665
  relevantSubPathParts.every((part, i) => part === schemaPathParts[i]) &&
2263
2666
  equivalentValue.scopeNodeName === scopeNode.name
2264
2667
  ) {
2668
+ // DEBUG
2265
2669
  continue;
2266
2670
  }
2267
2671
 
2268
2672
  const newEquivalentPath = this.joinPathParts([schemaPath, remainingPath]);
2269
2673
 
2674
+ // PERF: Detect repeated patterns in paths to prevent exponential blowup
2675
+ // Paths like `signature[0].attributes.properties[].attributes.properties[]...`
2676
+ // indicate recursive type structures that cause exponential schema explosion
2677
+ if (this.hasExcessivePatternRepetition(newEquivalentPath)) {
2678
+ if (traceId && debugLevel > 0) {
2679
+ console.info(
2680
+ 'Debug: skipping path with excessive pattern repetition',
2681
+ {
2682
+ path: newEquivalentPath,
2683
+ },
2684
+ );
2685
+ }
2686
+ continue;
2687
+ }
2688
+
2270
2689
  if (!equivalentScopeNode) {
2271
2690
  if (traceId) {
2272
2691
  console.info('Debug Propagation: missing equivalent scope info', {
@@ -2433,6 +2852,8 @@ export class ScopeDataStructure {
2433
2852
  usageEquivalency.scopeNodeName,
2434
2853
  ) as ScopeNode;
2435
2854
 
2855
+ if (!usageScopeNode) continue;
2856
+
2436
2857
  // Guard against infinite recursion by tracking which paths we've already
2437
2858
  // added from addComplexSourcePathVariables
2438
2859
  if (
@@ -2512,6 +2933,8 @@ export class ScopeDataStructure {
2512
2933
  usageEquivalency.scopeNodeName,
2513
2934
  ) as ScopeNode;
2514
2935
 
2936
+ if (!usageScopeNode) continue;
2937
+
2515
2938
  // This is put in place to avoid propagating array functions like 'filter' through complex equivalencies
2516
2939
  // but may cause problems if the funtion call is not on a known object (e.g. string or array)
2517
2940
  if (
@@ -2638,10 +3061,105 @@ export class ScopeDataStructure {
2638
3061
  this.intermediatesOrderIndex.set(pathId, databaseEntry);
2639
3062
 
2640
3063
  if (intermediateIndex === 0) {
2641
- const isValidSourceCandidate =
3064
+ let isValidSourceCandidate =
2642
3065
  pathInfo.schemaPath.startsWith('signature[') ||
2643
3066
  pathInfo.schemaPath.includes('functionCallReturnValue');
2644
- if (isValidSourceCandidate) {
3067
+
3068
+ // Check if path STARTS with a spread pattern like [...var]
3069
+ // This handles cases like [...files][][0] or [...files].sort(...).functionCallReturnValue[][0]
3070
+ // where the spread source variable needs to be resolved to a signature path.
3071
+ // We do this REGARDLESS of isValidSourceCandidate because even paths containing
3072
+ // functionCallReturnValue may need spread resolution to trace back to the signature.
3073
+ const spreadMatch = pathInfo.schemaPath.match(/^\[\.\.\.(\w+)\]/);
3074
+ if (spreadMatch) {
3075
+ const spreadVar = spreadMatch[1];
3076
+ const spreadPattern = spreadMatch[0]; // The full [...var] match
3077
+ const scopeNode = this.scopeNodes[pathInfo.scopeNodeName];
3078
+
3079
+ if (scopeNode?.equivalencies) {
3080
+ // Follow the equivalency chain to find a signature path
3081
+ // e.g., files (cyScope1) → files (root) → signature[0].files
3082
+ const resolveToSignature = (
3083
+ varName: string,
3084
+ currentScopeName: string,
3085
+ visited: Set<string>,
3086
+ ): { schemaPath: string; scopeNodeName: string } | null => {
3087
+ const visitKey = `${currentScopeName}::${varName}`;
3088
+ if (visited.has(visitKey)) return null;
3089
+ visited.add(visitKey);
3090
+
3091
+ const currentScope = this.scopeNodes[currentScopeName];
3092
+ if (!currentScope?.equivalencies) return null;
3093
+
3094
+ const varEquivs = currentScope.equivalencies[varName];
3095
+ if (!varEquivs) return null;
3096
+
3097
+ // First check if any equivalency directly points to a signature path
3098
+ const signatureEquiv = varEquivs.find((eq) =>
3099
+ eq.schemaPath.startsWith('signature['),
3100
+ );
3101
+ if (signatureEquiv) {
3102
+ return signatureEquiv;
3103
+ }
3104
+
3105
+ // Otherwise, follow the chain to other scopes
3106
+ for (const equiv of varEquivs) {
3107
+ // If the equivalency points to the same variable in a different scope,
3108
+ // follow the chain
3109
+ if (
3110
+ equiv.schemaPath === varName &&
3111
+ equiv.scopeNodeName !== currentScopeName
3112
+ ) {
3113
+ const result = resolveToSignature(
3114
+ varName,
3115
+ equiv.scopeNodeName,
3116
+ visited,
3117
+ );
3118
+ if (result) return result;
3119
+ }
3120
+ }
3121
+
3122
+ return null;
3123
+ };
3124
+
3125
+ const signatureEquiv = resolveToSignature(
3126
+ spreadVar,
3127
+ pathInfo.scopeNodeName,
3128
+ new Set(),
3129
+ );
3130
+ if (signatureEquiv) {
3131
+ // Replace ONLY the [...var] part with the resolved signature path
3132
+ // This preserves any suffix like .sort(...).functionCallReturnValue[][0]
3133
+ const resolvedPath = pathInfo.schemaPath.replace(
3134
+ spreadPattern,
3135
+ signatureEquiv.schemaPath,
3136
+ );
3137
+ // Add the resolved path as a source candidate
3138
+ if (
3139
+ !databaseEntry.sourceCandidates.some(
3140
+ (sc) =>
3141
+ sc.schemaPath === resolvedPath &&
3142
+ sc.scopeNodeName === pathInfo.scopeNodeName,
3143
+ )
3144
+ ) {
3145
+ databaseEntry.sourceCandidates.push({
3146
+ scopeNodeName: pathInfo.scopeNodeName,
3147
+ schemaPath: resolvedPath,
3148
+ });
3149
+ }
3150
+ isValidSourceCandidate = true;
3151
+ }
3152
+ }
3153
+ }
3154
+
3155
+ if (
3156
+ isValidSourceCandidate &&
3157
+ !databaseEntry.sourceCandidates.some(
3158
+ (sc) =>
3159
+ sc.schemaPath === pathInfo.schemaPath &&
3160
+ sc.scopeNodeName === pathInfo.scopeNodeName,
3161
+ )
3162
+ ) {
2645
3163
  databaseEntry.sourceCandidates.push(pathInfo);
2646
3164
  }
2647
3165
  } else {
@@ -2869,6 +3387,14 @@ export class ScopeDataStructure {
2869
3387
  }
2870
3388
  }
2871
3389
 
3390
+ // Ensure parameter-to-signature equivalencies are fully propagated.
3391
+ // When a parameter variable (e.g., `node`) is equivalenced to `signature[N]`,
3392
+ // all sub-paths of that variable should also appear under `signature[N]`.
3393
+ // This handles cases where the sub-path was added to the schema via a propagation
3394
+ // chain that already included the variable↔signature equivalency, causing the
3395
+ // cycle detection to prevent the reverse mapping.
3396
+ this.propagateParameterToSignaturePaths(scopeNode);
3397
+
2872
3398
  fillInSchemaGapsAndUnknowns(scopeNode, fillInUnknowns);
2873
3399
 
2874
3400
  if (final) {
@@ -2883,6 +3409,97 @@ export class ScopeDataStructure {
2883
3409
  }
2884
3410
  }
2885
3411
 
3412
+ /**
3413
+ * For each equivalency where a simple variable maps to signature[N],
3414
+ * ensure all sub-paths of that variable are reflected under signature[N].
3415
+ */
3416
+ private propagateParameterToSignaturePaths(scopeNode: ScopeNode) {
3417
+ // Helper: check if a type is a concrete scalar that cannot have sub-properties.
3418
+ const SCALAR_TYPES = new Set([
3419
+ 'string',
3420
+ 'number',
3421
+ 'boolean',
3422
+ 'bigint',
3423
+ 'symbol',
3424
+ 'void',
3425
+ 'never',
3426
+ ]);
3427
+ const isDefinitelyScalar = (type: string): boolean => {
3428
+ const parts = type.split('|').map((s) => s.trim());
3429
+ const base = parts.filter((s) => s !== 'undefined' && s !== 'null');
3430
+ return base.length > 0 && base.every((b) => SCALAR_TYPES.has(b));
3431
+ };
3432
+
3433
+ // Find variable → signature[N] equivalencies
3434
+ for (const [varName, equivalencies] of Object.entries(
3435
+ scopeNode.equivalencies,
3436
+ )) {
3437
+ // Only process simple variable names (no dots, brackets, or parens)
3438
+ if (
3439
+ varName.includes('.') ||
3440
+ varName.includes('[') ||
3441
+ varName.includes('(')
3442
+ ) {
3443
+ continue;
3444
+ }
3445
+
3446
+ for (const equiv of equivalencies) {
3447
+ if (
3448
+ equiv.scopeNodeName === scopeNode.name &&
3449
+ equiv.schemaPath.startsWith('signature[')
3450
+ ) {
3451
+ const signaturePath = equiv.schemaPath;
3452
+ const varPrefix = varName + '.';
3453
+ const varBracketPrefix = varName + '[';
3454
+
3455
+ // Find all schema keys starting with the variable
3456
+ for (const key in scopeNode.schema) {
3457
+ if (key.startsWith(varPrefix) || key.startsWith(varBracketPrefix)) {
3458
+ const suffix = key.slice(varName.length);
3459
+ const sigKey = signaturePath + suffix;
3460
+
3461
+ // Only add if the signature path doesn't already exist
3462
+ if (!scopeNode.schema[sigKey]) {
3463
+ // Check if this path represents variable conflation:
3464
+ // When a standalone variable (e.g., showWorkoutForm from useState)
3465
+ // appears as a sub-property of a scalar-typed ancestor (e.g.,
3466
+ // activity_type = "string"), it's from scope conflation, not real
3467
+ // property access. Block these while allowing legitimate built-in
3468
+ // accesses like string.length or string.slice.
3469
+ let isConflatedPath = false;
3470
+ let checkPos = signaturePath.length;
3471
+ while (true) {
3472
+ checkPos = sigKey.indexOf('.', checkPos + 1);
3473
+ if (checkPos === -1) break;
3474
+ const ancestorPath = sigKey.substring(0, checkPos);
3475
+ const ancestorType = scopeNode.schema[ancestorPath];
3476
+ if (ancestorType && isDefinitelyScalar(ancestorType)) {
3477
+ // Ancestor is scalar — check if the immediate sub-property
3478
+ // is also a standalone variable (indicating conflation)
3479
+ const afterDot = sigKey.substring(checkPos + 1);
3480
+ const nextSep = afterDot.search(/[.\[]/);
3481
+ const subPropName =
3482
+ nextSep === -1
3483
+ ? afterDot
3484
+ : afterDot.substring(0, nextSep);
3485
+ if (scopeNode.schema[subPropName] !== undefined) {
3486
+ isConflatedPath = true;
3487
+ break;
3488
+ }
3489
+ }
3490
+ }
3491
+
3492
+ if (!isConflatedPath) {
3493
+ scopeNode.schema[sigKey] = scopeNode.schema[key];
3494
+ }
3495
+ }
3496
+ }
3497
+ }
3498
+ }
3499
+ }
3500
+ }
3501
+ }
3502
+
2886
3503
  private filterAndConvertSchema({
2887
3504
  filterPath,
2888
3505
  newPath,
@@ -2969,6 +3586,9 @@ export class ScopeDataStructure {
2969
3586
  equivalentValueSchemaPathParts.length,
2970
3587
  ),
2971
3588
  ]);
3589
+ // PERF: Skip keys with repeated function-call signature patterns
3590
+ // to prevent recursive type expansion (e.g., string.localeCompare returns string)
3591
+ if (this.hasExcessivePatternRepetition(newKey)) continue;
2972
3592
  resolvedSchema[newKey] = value;
2973
3593
  }
2974
3594
  }
@@ -2991,6 +3611,8 @@ export class ScopeDataStructure {
2991
3611
  if (!subSchema) continue;
2992
3612
 
2993
3613
  for (const resolvedKey in subSchema) {
3614
+ // PERF: Skip keys with repeated function-call signature patterns
3615
+ if (this.hasExcessivePatternRepetition(resolvedKey)) continue;
2994
3616
  if (
2995
3617
  !resolvedSchema[resolvedKey] ||
2996
3618
  subSchema[resolvedKey] === 'unknown'
@@ -3137,7 +3759,12 @@ export class ScopeDataStructure {
3137
3759
  );
3138
3760
  }
3139
3761
 
3762
+ // CRITICAL: Set onlyEquivalencies to true to prevent database modifications
3763
+ // during this "getter" method. See comment in getFunctionSignature.
3764
+ const wasOnlyEquivalencies = this.onlyEquivalencies;
3765
+ this.onlyEquivalencies = true;
3140
3766
  this.validateSchema(scopeNode, true, fillInUnknowns);
3767
+ this.onlyEquivalencies = wasOnlyEquivalencies;
3141
3768
 
3142
3769
  const { schema } = scopeNode;
3143
3770
 
@@ -3171,10 +3798,29 @@ export class ScopeDataStructure {
3171
3798
  }
3172
3799
  }
3173
3800
  }
3174
- return mergedSchema;
3801
+ return this.filterDuplicateKeys(mergedSchema);
3175
3802
  }
3176
3803
 
3177
- return schema;
3804
+ return this.filterDuplicateKeys(schema);
3805
+ }
3806
+
3807
+ /**
3808
+ * Filter out ::cyDuplicateKey:: entries from a schema.
3809
+ * These are internal markers for tracking variable reassignments
3810
+ * and should not appear in output schemas or LLM prompts.
3811
+ */
3812
+ private filterDuplicateKeys(
3813
+ schema: Record<string, string>,
3814
+ ): Record<string, string> {
3815
+ return Object.entries(schema).reduce(
3816
+ (acc, [key, value]) => {
3817
+ if (!key.includes('::cyDuplicateKey')) {
3818
+ acc[key] = value;
3819
+ }
3820
+ return acc;
3821
+ },
3822
+ {} as Record<string, string>,
3823
+ );
3178
3824
  }
3179
3825
 
3180
3826
  getEquivalencies(scopeName?: string) {
@@ -3204,26 +3850,270 @@ export class ScopeDataStructure {
3204
3850
  return {};
3205
3851
  }
3206
3852
 
3853
+ // Collect all descendant scope names (including the scope itself)
3854
+ // This ensures we include external calls from nested scopes like cyScope2
3855
+ const getAllDescendantScopeNames = (
3856
+ node: import('./helpers/ScopeTreeManager').ScopeTreeNode,
3857
+ ): Set<string> => {
3858
+ const names = new Set<string>([node.name]);
3859
+ for (const child of node.children) {
3860
+ for (const name of getAllDescendantScopeNames(child)) {
3861
+ names.add(name);
3862
+ }
3863
+ }
3864
+ return names;
3865
+ };
3866
+
3867
+ const treeNode = this.scopeTreeManager.findNode(scopeNode.name);
3868
+ const descendantScopeNames = treeNode
3869
+ ? getAllDescendantScopeNames(treeNode)
3870
+ : new Set<string>([scopeNode.name]);
3871
+
3872
+ // Get all external function calls made from this scope or any descendant scope
3873
+ // This allows us to include prop equivalencies from JSX components
3874
+ // that were rendered in nested scopes (e.g., FileTableRow called from cyScope2)
3875
+ const externalCallsFromScope = this.externalFunctionCalls.filter((efc) =>
3876
+ descendantScopeNames.has(efc.callScope),
3877
+ );
3878
+ const externalCallNames = new Set(
3879
+ externalCallsFromScope.map((efc) => efc.name),
3880
+ );
3881
+
3882
+ // Helper to check if a usage belongs to this scope (directly, via descendant, or via external call)
3883
+ const usageMatchesScope = (usage: { scopeNodeName: string }) =>
3884
+ descendantScopeNames.has(usage.scopeNodeName) ||
3885
+ externalCallNames.has(usage.scopeNodeName);
3886
+
3207
3887
  const entries = this.equivalencyDatabase.filter((entry) =>
3208
- entry.usages.some((usage) => usage.scopeNodeName === scopeNode.name),
3888
+ entry.usages.some(usageMatchesScope),
3209
3889
  );
3210
- return entries.reduce(
3211
- (acc, entry) => {
3212
- if (entry.sourceCandidates.length === 0) return acc;
3213
- const usages = entry.usages.filter(
3214
- (u) => u.scopeNodeName === scopeNode.name,
3215
- );
3890
+
3891
+ // Helper to resolve a source candidate through equivalency chains to find signature paths
3892
+ const resolveToSignature = (
3893
+ source: Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>,
3894
+ visited: Set<string>,
3895
+ ): Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[] => {
3896
+ const visitKey = `${source.scopeNodeName}::${source.schemaPath}`;
3897
+ if (visited.has(visitKey)) return [];
3898
+ visited.add(visitKey);
3899
+
3900
+ // If already a signature path, return as-is
3901
+ if (source.schemaPath.startsWith('signature[')) {
3902
+ return [source];
3903
+ }
3904
+
3905
+ const currentScope = this.scopeNodes[source.scopeNodeName];
3906
+ if (!currentScope?.equivalencies) return [source];
3907
+
3908
+ // Check for direct equivalencies FIRST (full path match)
3909
+ // This ensures paths like "useMemo(...).functionCallReturnValue" follow to "cyScope1::returnValue"
3910
+ // before prefix matching tries "useMemo(...)" which goes to the useMemo scope
3911
+ const directEquivs = currentScope.equivalencies[source.schemaPath];
3912
+ if (directEquivs?.length > 0) {
3913
+ const results: Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[] =
3914
+ [];
3915
+ for (const equiv of directEquivs) {
3916
+ const resolved = resolveToSignature(
3917
+ {
3918
+ scopeNodeName: equiv.scopeNodeName,
3919
+ schemaPath: equiv.schemaPath,
3920
+ },
3921
+ visited,
3922
+ );
3923
+ results.push(...resolved);
3924
+ }
3925
+ if (results.length > 0) return results;
3926
+ }
3927
+
3928
+ // Handle spread patterns like [...items].sort().functionCallReturnValue
3929
+ // Extract the spread variable and resolve it through the equivalency chain
3930
+ const spreadMatch = source.schemaPath.match(/^\[\.\.\.(\w+)\]/);
3931
+ if (spreadMatch) {
3932
+ const spreadVar = spreadMatch[1];
3933
+ const spreadPattern = spreadMatch[0];
3934
+ const varEquivs = currentScope.equivalencies[spreadVar];
3935
+
3936
+ if (varEquivs?.length > 0) {
3937
+ const results: Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[] =
3938
+ [];
3939
+ for (const equiv of varEquivs) {
3940
+ // Follow the variable equivalency and then resolve from there
3941
+ const resolvedVar = resolveToSignature(
3942
+ {
3943
+ scopeNodeName: equiv.scopeNodeName,
3944
+ schemaPath: equiv.schemaPath,
3945
+ },
3946
+ visited,
3947
+ );
3948
+ // For each resolved variable path, create the full path with array element suffix
3949
+ for (const rv of resolvedVar) {
3950
+ if (rv.schemaPath.startsWith('signature[')) {
3951
+ // Get the suffix after the spread pattern
3952
+ let suffix = source.schemaPath.slice(spreadPattern.length);
3953
+
3954
+ // Clean the suffix: strip array method chains like .sort(...).functionCallReturnValue[]
3955
+ // These don't change the data identity, just transform it.
3956
+ // Keep only the final element access parts like [0], [1], etc.
3957
+ // Pattern: strip everything from a method call up through functionCallReturnValue[]
3958
+ suffix = suffix.replace(
3959
+ /\.\w+\([^)]*\)\.functionCallReturnValue\[\]/g,
3960
+ '',
3961
+ );
3962
+ // Also handle simpler case without nested parens
3963
+ suffix = suffix.replace(
3964
+ /\.sort\(\w*\(\)\)\.functionCallReturnValue\[\]/g,
3965
+ '',
3966
+ );
3967
+
3968
+ // Add [] to indicate array element access from the spread
3969
+ const resolvedPath = rv.schemaPath + '[]' + suffix;
3970
+ results.push({
3971
+ scopeNodeName: rv.scopeNodeName,
3972
+ schemaPath: resolvedPath,
3973
+ });
3974
+ }
3975
+ }
3976
+ }
3977
+ if (results.length > 0) return results;
3978
+ }
3979
+ }
3980
+
3981
+ // Try to find prefix equivalencies that can resolve this path
3982
+ // For path like "cyScope3().signature[0][0]", check "cyScope3().signature[0]", etc.
3983
+ const pathParts = this.splitPath(source.schemaPath);
3984
+ for (let i = pathParts.length - 1; i > 0; i--) {
3985
+ const prefix = this.joinPathParts(pathParts.slice(0, i));
3986
+ const suffix = this.joinPathParts(pathParts.slice(i));
3987
+ const prefixEquivs = currentScope.equivalencies[prefix];
3988
+
3989
+ if (prefixEquivs?.length > 0) {
3990
+ const results: Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[] =
3991
+ [];
3992
+ for (const equiv of prefixEquivs) {
3993
+ const newPath = this.joinPathParts([equiv.schemaPath, suffix]);
3994
+ const resolved = resolveToSignature(
3995
+ { scopeNodeName: equiv.scopeNodeName, schemaPath: newPath },
3996
+ visited,
3997
+ );
3998
+ results.push(...resolved);
3999
+ }
4000
+ if (results.length > 0) return results;
4001
+ }
4002
+ }
4003
+
4004
+ return [source];
4005
+ };
4006
+
4007
+ const acc = entries.reduce(
4008
+ (result, entry) => {
4009
+ if (entry.sourceCandidates.length === 0) return result;
4010
+ const usages = entry.usages.filter(usageMatchesScope);
3216
4011
  for (const usage of usages) {
3217
- acc[usage.schemaPath] ||= [];
3218
- acc[usage.schemaPath].push(...entry.sourceCandidates);
4012
+ result[usage.schemaPath] ||= [];
4013
+ // Resolve each source candidate through the equivalency chain
4014
+ for (const source of entry.sourceCandidates) {
4015
+ const resolvedSources = resolveToSignature(source, new Set());
4016
+ result[usage.schemaPath].push(...resolvedSources);
4017
+ }
3219
4018
  }
3220
- return acc;
4019
+ return result;
3221
4020
  },
3222
4021
  {} as Record<
3223
4022
  string,
3224
4023
  Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[]
3225
4024
  >,
3226
4025
  );
4026
+
4027
+ // Post-processing: enrich useState-backed sources with co-located external
4028
+ // function calls. When a useState value resolves to a setter variable that
4029
+ // lives in the same scope as a fetch/API call, that fetch is a data source.
4030
+ this.enrichUseStateSourcesWithCoLocatedCalls(acc);
4031
+
4032
+ return acc;
4033
+ }
4034
+
4035
+ /**
4036
+ * For each source that ends at a useState path, check if the setter was called
4037
+ * from a scope that also contains external function calls (like fetch).
4038
+ * If so, add those external calls as additional source candidates.
4039
+ */
4040
+ private enrichUseStateSourcesWithCoLocatedCalls(
4041
+ acc: Record<string, Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[]>,
4042
+ ) {
4043
+ const rootScopeName = this.scopeTreeManager.getRootName();
4044
+ const rootScope = this.scopeNodes[rootScopeName];
4045
+ if (!rootScope) return;
4046
+
4047
+ // Collect all descendants for each scope node
4048
+ const getAllDescendants = (
4049
+ node: import('./helpers/ScopeTreeManager').ScopeTreeNode,
4050
+ ): Set<string> => {
4051
+ const names = new Set<string>([node.name]);
4052
+ for (const child of node.children) {
4053
+ for (const name of getAllDescendants(child)) {
4054
+ names.add(name);
4055
+ }
4056
+ }
4057
+ return names;
4058
+ };
4059
+
4060
+ for (const [usagePath, sources] of Object.entries(acc)) {
4061
+ const additionalSources: Pick<
4062
+ ScopeVariable,
4063
+ 'scopeNodeName' | 'schemaPath'
4064
+ >[] = [];
4065
+
4066
+ for (const source of sources) {
4067
+ // Check if this source is a useState-related terminal path
4068
+ // (e.g., useState(X).functionCallReturnValue[1] or useState(X).signature[0])
4069
+ if (!source.schemaPath.match(/^useState\([^)]*\)\./)) continue;
4070
+
4071
+ // Find the useState call from the source path
4072
+ const useStateCallMatch = source.schemaPath.match(
4073
+ /^(useState\([^)]*\))\./,
4074
+ );
4075
+ if (!useStateCallMatch) continue;
4076
+ const useStateCall = useStateCallMatch[1];
4077
+
4078
+ // Look in the root scope for the useState value equivalency
4079
+ // which tells us where the setter was called from
4080
+ const valuePath = `${useStateCall}.functionCallReturnValue[0]`;
4081
+ const valueEquivs = rootScope.equivalencies[valuePath];
4082
+ if (!valueEquivs) continue;
4083
+
4084
+ for (const equiv of valueEquivs) {
4085
+ // Find the scope where the setter was called
4086
+ const setterScopeName = equiv.scopeNodeName;
4087
+ const setterScopeTree =
4088
+ this.scopeTreeManager.findNode(setterScopeName);
4089
+ if (!setterScopeTree) continue;
4090
+
4091
+ // Get all descendant scope names from the setter scope
4092
+ const relatedScopes = getAllDescendants(setterScopeTree);
4093
+
4094
+ // Find external function calls in those scopes whose return values
4095
+ // are actually consumed (assigned to a variable). This excludes
4096
+ // fire-and-forget calls like analytics.track() or console.log().
4097
+ const coLocatedCalls = this.externalFunctionCalls.filter(
4098
+ (efc) =>
4099
+ relatedScopes.has(efc.callScope) &&
4100
+ efc.receivingVariableNames &&
4101
+ efc.receivingVariableNames.length > 0,
4102
+ );
4103
+
4104
+ for (const call of coLocatedCalls) {
4105
+ additionalSources.push({
4106
+ scopeNodeName: call.callScope,
4107
+ schemaPath: `${call.callSignature}.functionCallReturnValue`,
4108
+ });
4109
+ }
4110
+ }
4111
+ }
4112
+
4113
+ if (additionalSources.length > 0) {
4114
+ acc[usagePath].push(...additionalSources);
4115
+ }
4116
+ }
3227
4117
  }
3228
4118
 
3229
4119
  getUsageEquivalencies(functionName?: string) {
@@ -3238,6 +4128,7 @@ export class ScopeDataStructure {
3238
4128
  (candidate) => candidate.scopeNodeName === scopeNode.name,
3239
4129
  ),
3240
4130
  );
4131
+
3241
4132
  return entries.reduce(
3242
4133
  (acc, entry) => {
3243
4134
  if (entry.usages.length === 0) return acc;
@@ -3281,12 +4172,14 @@ export class ScopeDataStructure {
3281
4172
  );
3282
4173
 
3283
4174
  const equivalencies = this.getEquivalencies(functionName);
4175
+ const scopeName = functionName ?? this.scopeTreeManager.getRootName();
4176
+
3284
4177
  for (const equivalenceKey in equivalencies ?? {}) {
3285
4178
  for (const equivalenceValue of equivalencies[equivalenceKey]) {
3286
4179
  const schemaPath = equivalenceValue.schemaPath;
3287
4180
  if (
3288
4181
  schemaPath.startsWith('signature[') &&
3289
- equivalenceValue.scopeNodeName === functionName &&
4182
+ equivalenceValue.scopeNodeName === scopeName &&
3290
4183
  !signatureInSchema[schemaPath]
3291
4184
  ) {
3292
4185
  signatureInSchema[schemaPath] = 'unknown';
@@ -3302,7 +4195,188 @@ export class ScopeDataStructure {
3302
4195
 
3303
4196
  this.validateSchema(tempScopeNode, true, fillInUnknowns);
3304
4197
 
3305
- return tempScopeNode.schema;
4198
+ // After validateSchema has filled in types, propagate nested paths from
4199
+ // variables to their signature equivalents.
4200
+ // e.g., workouts[].activity_type -> signature[0].workouts[].activity_type
4201
+ //
4202
+ // Build a map of variable names that are equivalent to signature paths
4203
+ // e.g., { 'workouts': 'signature[0].workouts' }
4204
+ const variableToSignatureMap: Record<string, string> = {};
4205
+
4206
+ for (const equivalenceKey in equivalencies ?? {}) {
4207
+ for (const equivalenceValue of equivalencies[equivalenceKey]) {
4208
+ const schemaPath = equivalenceValue.schemaPath;
4209
+ // Track which variables map to signature paths
4210
+ // equivalenceKey is the variable name (e.g., 'workouts')
4211
+ // schemaPath is where it comes from (e.g., 'signature[0].workouts')
4212
+ if (
4213
+ schemaPath.startsWith('signature[') &&
4214
+ equivalenceValue.scopeNodeName === scopeName
4215
+ ) {
4216
+ variableToSignatureMap[equivalenceKey] = schemaPath;
4217
+ }
4218
+ }
4219
+ }
4220
+
4221
+ // Enrich schema with deeply nested paths from internal function call scopes.
4222
+ // When a function call like traverse(tree) exists, and traverse's scope has
4223
+ // signature[0].children[path][entityName] (from propagateParameterToSignaturePaths),
4224
+ // we need to map those paths back to the argument variable (tree) in this scope.
4225
+ // This handles cases where cycle detection prevented the equivalency chain from
4226
+ // propagating deep paths during Phase 2 batch queue processing.
4227
+ for (const equivalenceKey in equivalencies ?? {}) {
4228
+ // Look for keys matching function call pattern: funcName(...).signature[N]
4229
+ const funcCallMatch = equivalenceKey.match(
4230
+ /^([^(]+)\(.*?\)\.(signature\[\d+\])$/,
4231
+ );
4232
+ if (!funcCallMatch) continue;
4233
+
4234
+ const calledFunctionName = funcCallMatch[1];
4235
+ const signatureParam = funcCallMatch[2]; // e.g., "signature[0]"
4236
+
4237
+ for (const equivalenceValue of equivalencies[equivalenceKey]) {
4238
+ if (equivalenceValue.scopeNodeName !== scopeName) continue;
4239
+
4240
+ const targetVariable = equivalenceValue.schemaPath;
4241
+
4242
+ // Get the called function's schema (includes propagated parameter paths)
4243
+ const childSchema = this.getSchema({
4244
+ scopeName: calledFunctionName,
4245
+ });
4246
+ if (!childSchema) continue;
4247
+
4248
+ // Map child function's signature paths to parent variable paths
4249
+ const sigPrefix = signatureParam + '.';
4250
+ const sigBracketPrefix = signatureParam + '[';
4251
+ for (const childKey in childSchema) {
4252
+ let suffix: string | null = null;
4253
+ if (childKey.startsWith(sigPrefix)) {
4254
+ suffix = childKey.slice(signatureParam.length);
4255
+ } else if (childKey.startsWith(sigBracketPrefix)) {
4256
+ suffix = childKey.slice(signatureParam.length);
4257
+ }
4258
+
4259
+ if (suffix !== null) {
4260
+ const parentKey = targetVariable + suffix;
4261
+ if (!schema[parentKey]) {
4262
+ schema[parentKey] = childSchema[childKey];
4263
+ }
4264
+ }
4265
+ }
4266
+ }
4267
+ }
4268
+
4269
+ // Helper: check if a type is a concrete scalar that cannot have sub-properties.
4270
+ // e.g., "string", "number | undefined", "boolean | null" are scalar.
4271
+ // "object", "array", "function", "unknown", "Workout", etc. are NOT scalar.
4272
+ const SCALAR_TYPES = new Set([
4273
+ 'string',
4274
+ 'number',
4275
+ 'boolean',
4276
+ 'bigint',
4277
+ 'symbol',
4278
+ 'void',
4279
+ 'never',
4280
+ ]);
4281
+ const isDefinitelyScalarType = (type: string): boolean => {
4282
+ const parts = type.split('|').map((s) => s.trim());
4283
+ const base = parts.filter((s) => s !== 'undefined' && s !== 'null');
4284
+ return base.length > 0 && base.every((b) => SCALAR_TYPES.has(b));
4285
+ };
4286
+
4287
+ // Propagate nested paths from variables to their signature equivalents
4288
+ // e.g., if workouts = signature[0].workouts, then workouts[].title becomes
4289
+ // signature[0].workouts[].title
4290
+ for (const schemaKey in schema) {
4291
+ // Skip keys that already start with signature[
4292
+ if (schemaKey.startsWith('signature[')) continue;
4293
+
4294
+ // Check if this key starts with a variable that maps to a signature path
4295
+ for (const [variableName, signaturePath] of Object.entries(
4296
+ variableToSignatureMap,
4297
+ )) {
4298
+ // Check if schemaKey starts with variableName followed by a property accessor
4299
+ // e.g., 'workouts[]' starts with 'workouts'
4300
+ if (
4301
+ schemaKey === variableName ||
4302
+ schemaKey.startsWith(variableName + '.') ||
4303
+ schemaKey.startsWith(variableName + '[')
4304
+ ) {
4305
+ // Transform the path: replace the variable prefix with the signature path
4306
+ const suffix = schemaKey.slice(variableName.length);
4307
+ const signatureKey = signaturePath + suffix;
4308
+
4309
+ // Add to schema if not already present
4310
+ if (!tempScopeNode.schema[signatureKey]) {
4311
+ // Check if this path represents variable conflation:
4312
+ // When a standalone variable (e.g., showWorkoutForm from useState)
4313
+ // appears as a sub-property of a scalar-typed ancestor (e.g.,
4314
+ // activity_type = "string"), it's from scope conflation, not real
4315
+ // property access. Block these while allowing legitimate built-in
4316
+ // accesses like string.length or string.slice.
4317
+ let isConflatedPath = false;
4318
+ let checkPos = signaturePath.length;
4319
+ while (true) {
4320
+ checkPos = signatureKey.indexOf('.', checkPos + 1);
4321
+ if (checkPos === -1) break;
4322
+ const ancestorPath = signatureKey.substring(0, checkPos);
4323
+ const ancestorType = tempScopeNode.schema[ancestorPath];
4324
+ if (ancestorType && isDefinitelyScalarType(ancestorType)) {
4325
+ // Ancestor is scalar — check if the immediate sub-property
4326
+ // is also a standalone variable (indicating conflation)
4327
+ const afterDot = signatureKey.substring(checkPos + 1);
4328
+ const nextSep = afterDot.search(/[.\[]/);
4329
+ const subPropName =
4330
+ nextSep === -1 ? afterDot : afterDot.substring(0, nextSep);
4331
+ if (schema[subPropName] !== undefined) {
4332
+ isConflatedPath = true;
4333
+ break;
4334
+ }
4335
+ }
4336
+ }
4337
+
4338
+ if (!isConflatedPath) {
4339
+ tempScopeNode.schema[signatureKey] = schema[schemaKey];
4340
+ }
4341
+ }
4342
+ }
4343
+ }
4344
+ }
4345
+
4346
+ // Post-process: filter out conflated signature paths.
4347
+ // During phase 2 scope analysis, useState(false) conflation can create
4348
+ // bad paths like signature[0].mockWorkouts[].activity_type.showWorkoutForm
4349
+ // directly in scopeNode.schema. These flow through signatureInSchema into
4350
+ // tempScopeNode.schema without any guard. Filter them out here by checking:
4351
+ // 1. An ancestor in the path has a concrete scalar type (string, number, boolean, etc.)
4352
+ // 2. The immediate sub-property of that scalar ancestor is also a standalone
4353
+ // variable in the schema (indicating conflation, not a real property access)
4354
+ for (const key of Object.keys(tempScopeNode.schema)) {
4355
+ if (!key.startsWith('signature[')) continue;
4356
+
4357
+ // Walk through the path looking for scalar-typed ancestors
4358
+ let pos = 0;
4359
+ while (true) {
4360
+ pos = key.indexOf('.', pos + 1);
4361
+ if (pos === -1) break;
4362
+ const ancestorPath = key.substring(0, pos);
4363
+ const ancestorType = tempScopeNode.schema[ancestorPath];
4364
+ if (ancestorType && isDefinitelyScalarType(ancestorType)) {
4365
+ // Found a scalar ancestor — check if the sub-property name
4366
+ // is a standalone variable in the getSchema() result
4367
+ const afterDot = key.substring(pos + 1);
4368
+ const nextSep = afterDot.search(/[.\[]/);
4369
+ const subPropName =
4370
+ nextSep === -1 ? afterDot : afterDot.substring(0, nextSep);
4371
+ if (schema[subPropName] !== undefined) {
4372
+ delete tempScopeNode.schema[key];
4373
+ break;
4374
+ }
4375
+ }
4376
+ }
4377
+ }
4378
+
4379
+ return this.filterDuplicateKeys(tempScopeNode.schema);
3306
4380
  }
3307
4381
 
3308
4382
  getReturnValue({
@@ -3312,6 +4386,15 @@ export class ScopeDataStructure {
3312
4386
  functionName?: string;
3313
4387
  fillInUnknowns?: boolean;
3314
4388
  }) {
4389
+ // Trigger finalization on all managers to apply any pending updates
4390
+ // (e.g., ref type propagation to external function call schemas)
4391
+ const rootScope = this.scopeNodes[this.scopeTreeManager.getRootName()];
4392
+ if (rootScope) {
4393
+ for (const manager of this.equivalencyManagers) {
4394
+ manager.finalize(rootScope, this);
4395
+ }
4396
+ }
4397
+
3315
4398
  const scopeName = functionName ?? this.scopeTreeManager.getRootName();
3316
4399
  const scopeNode = this.scopeNodes[scopeName];
3317
4400
 
@@ -3322,7 +4405,8 @@ export class ScopeDataStructure {
3322
4405
  scopeNode: scopeNode,
3323
4406
  });
3324
4407
  } else {
3325
- for (const externalFunctionCall of this.externalFunctionCalls) {
4408
+ // Use getExternalFunctionCalls() which cleans cyScope from schemas
4409
+ for (const externalFunctionCall of this.getExternalFunctionCalls()) {
3326
4410
  const functionNameParts = this.splitPath(functionName).map((p) =>
3327
4411
  this.functionOrScopeName(p),
3328
4412
  );
@@ -3354,7 +4438,17 @@ export class ScopeDataStructure {
3354
4438
  // Include function paths even if their return value wasn't captured
3355
4439
  // This ensures methods like onAuthStateChange are included in the schema
3356
4440
  // But exclude signature entries (they should only be included via functionCallReturnValue paths)
3357
- (schema[key] === 'function' && key.indexOf('signature[') === -1),
4441
+ // Also exclude bare function call signatures - paths that are JUST a call like
4442
+ // "useCustomSizes(projectSlug)" should not be included as return values.
4443
+ // These represent "the function exists" not actual return data, and including
4444
+ // them causes nested path bugs in dependencySchemas.
4445
+ (schema[key] === 'function' &&
4446
+ key.indexOf('signature[') === -1 &&
4447
+ // Exclude bare call signatures: function calls with no dots OUTSIDE parentheses
4448
+ // e.g., "useCustomSizes(projectSlug)" is bare (exclude)
4449
+ // e.g., "loadProject({nested.property})" is bare - dots are inside args (exclude)
4450
+ // e.g., "getSupabase().auth.method()" has dots outside - method chain (include)
4451
+ !this.isBareCallSignature(key)),
3358
4452
  )
3359
4453
  .reduce(
3360
4454
  (acc, key) => {
@@ -3364,7 +4458,10 @@ export class ScopeDataStructure {
3364
4458
  for (const path in schema) {
3365
4459
  const pathParts = this.splitPath(path);
3366
4460
  if (pathParts.every((p, i) => keyParts[i] === p)) {
3367
- acc[path] = schema[path];
4461
+ // Also exclude bare call signatures from prefix paths
4462
+ if (!this.isBareCallSignature(path)) {
4463
+ acc[path] = schema[path];
4464
+ }
3368
4465
  }
3369
4466
  }
3370
4467
 
@@ -3378,14 +4475,73 @@ export class ScopeDataStructure {
3378
4475
 
3379
4476
  const tempScopeNode = this.createTempScopeNode(scopeName, resolvedSchema);
3380
4477
 
4478
+ // CRITICAL: Set onlyEquivalencies to true to prevent database modifications
4479
+ // during this "getter" method. See comment in getFunctionSignature.
4480
+ const wasOnlyEquivalencies = this.onlyEquivalencies;
4481
+ this.onlyEquivalencies = true;
3381
4482
  this.validateSchema(tempScopeNode, true, fillInUnknowns);
4483
+ this.onlyEquivalencies = wasOnlyEquivalencies;
4484
+
4485
+ // Remove bare call signatures from the return value schema.
4486
+ // fillInSchemaGapsAndUnknowns may add parent paths like "useCustomSizes(projectSlug)"
4487
+ // when it sees "useCustomSizes(projectSlug).functionCallReturnValue". These bare
4488
+ // call signatures represent "the function exists" not actual return data, and
4489
+ // including them causes nested path bugs in dependencySchemas.
4490
+ const resultSchema = tempScopeNode.schema;
4491
+ for (const key of Object.keys(resultSchema)) {
4492
+ if (this.isBareCallSignature(key)) {
4493
+ delete resultSchema[key];
4494
+ }
4495
+ }
4496
+
4497
+ return resultSchema;
4498
+ }
3382
4499
 
3383
- return tempScopeNode.schema;
4500
+ /**
4501
+ * Checks if a schema key is a "bare call signature" - a function call with no
4502
+ * method chain before it and no path segments after it.
4503
+ *
4504
+ * A bare call signature represents "this function exists" rather than actual
4505
+ * return data, and including them causes nested path bugs in dependencySchemas.
4506
+ *
4507
+ * Examples:
4508
+ * - "useCustomSizes(projectSlug)" -> bare (true)
4509
+ * - "loadProject({nested.property})" -> bare (dots are inside args, true)
4510
+ * - "getSupabase().auth.method()" -> not bare (has dots outside parens, false)
4511
+ * - "useProject().functionCallReturnValue" -> not bare (has path after, false)
4512
+ */
4513
+ private isBareCallSignature(key: string): boolean {
4514
+ // Must end with ) and contain ( to be a call
4515
+ if (!key.endsWith(')') || key.indexOf('(') === -1) {
4516
+ return false;
4517
+ }
4518
+
4519
+ // Check if there are any dots OUTSIDE of parentheses
4520
+ // Strip out content inside balanced parentheses, then check for dots
4521
+ let depth = 0;
4522
+ let hasDotsOutsideParens = false;
4523
+
4524
+ for (let i = 0; i < key.length; i++) {
4525
+ const char = key[i];
4526
+ if (char === '(') {
4527
+ depth++;
4528
+ } else if (char === ')') {
4529
+ depth--;
4530
+ } else if (char === '.' && depth === 0) {
4531
+ hasDotsOutsideParens = true;
4532
+ break;
4533
+ }
4534
+ }
4535
+
4536
+ // It's a bare call signature if there are no dots outside parentheses
4537
+ return !hasDotsOutsideParens;
3384
4538
  }
3385
4539
 
3386
4540
  /**
3387
4541
  * Replaces cyScope placeholder references (e.g., cyScope10()) in schema keys
3388
4542
  * with the actual callback function text from the corresponding scope node.
4543
+ * If the scope text can't be found, uses a generic fallback to avoid leaking
4544
+ * internal cyScope names into stored data.
3389
4545
  */
3390
4546
  private replaceCyScopePlaceholders(
3391
4547
  schema: Record<string, string>,
@@ -3401,10 +4557,10 @@ export class ScopeDataStructure {
3401
4557
  for (const match of matches) {
3402
4558
  const cyScopeName = `cyScope${match[1]}`;
3403
4559
  const scopeText = this.findCyScopeText(cyScopeName);
3404
- if (scopeText) {
3405
- // Replace cyScope10() with the actual callback text
3406
- newKey = newKey.replace(match[0], scopeText);
3407
- }
4560
+ // Always replace cyScope references - use actual text if available,
4561
+ // otherwise use a generic callback placeholder
4562
+ const replacement = scopeText || '() => {}';
4563
+ newKey = newKey.replace(match[0], replacement);
3408
4564
  }
3409
4565
 
3410
4566
  result[newKey] = value;
@@ -3462,34 +4618,444 @@ export class ScopeDataStructure {
3462
4618
  return scopeText;
3463
4619
  }
3464
4620
 
3465
- getEquivalentSignatureVariables() {
4621
+ getEquivalentSignatureVariables(): Record<string, string | string[]> {
3466
4622
  const scopeNode = this.scopeNodes[this.scopeTreeManager.getRootName()];
3467
4623
 
3468
- const equivalentSignatureVariables: Record<string, string> = {};
4624
+ const equivalentSignatureVariables: Record<string, string | string[]> = {};
4625
+
4626
+ // Helper to add equivalencies - accumulates into array if multiple values for same key
4627
+ // This is critical for OR expressions like `x = a || b` where x should map to both a and b
4628
+ const addEquivalency = (key: string, value: string) => {
4629
+ const existing = equivalentSignatureVariables[key];
4630
+ if (existing === undefined) {
4631
+ // First value - store as string
4632
+ equivalentSignatureVariables[key] = value;
4633
+ } else if (typeof existing === 'string') {
4634
+ if (existing !== value) {
4635
+ // Second different value - convert to array
4636
+ equivalentSignatureVariables[key] = [existing, value];
4637
+ }
4638
+ // Same value - no change needed
4639
+ } else {
4640
+ // Already an array - add if not already present
4641
+ if (!existing.includes(value)) {
4642
+ existing.push(value);
4643
+ }
4644
+ }
4645
+ };
4646
+
3469
4647
  for (const [path, equivalentValues] of Object.entries(
3470
4648
  scopeNode.equivalencies,
3471
4649
  )) {
3472
4650
  for (const equivalentValue of equivalentValues) {
4651
+ // Case 1: Props/signature equivalencies (existing behavior)
4652
+ // Maps local variable names to their signature paths
4653
+ // e.g., "propValue" -> "signature[0].prop"
3473
4654
  if (path.startsWith('signature[')) {
3474
- equivalentSignatureVariables[equivalentValue.schemaPath] = path;
4655
+ addEquivalency(equivalentValue.schemaPath, path);
3475
4656
  }
3476
- }
3477
- }
3478
4657
 
3479
- return equivalentSignatureVariables;
3480
- }
4658
+ // Case 2: Hook variable equivalencies (new behavior)
4659
+ // The equivalencies are stored as: path = variable name, schemaPath = data source
4660
+ // e.g., path = "debugFetcher", schemaPath = "useFetcher<...>().functionCallReturnValue"
4661
+ // We need to map: "debugFetcher" -> "useFetcher<...>()"
4662
+ // This enables resolving paths like "debugFetcher.state" to
4663
+ // "useFetcher<...>().state" for execution flow validation
4664
+ if (equivalentValue.schemaPath.endsWith('.functionCallReturnValue')) {
4665
+ // Extract the hook call path (everything before .functionCallReturnValue)
4666
+ let hookCallPath = equivalentValue.schemaPath.slice(
4667
+ 0,
4668
+ -'.functionCallReturnValue'.length,
4669
+ );
4670
+ // Only include if it looks like a hook call (contains parentheses)
4671
+ // and the variable name (path) is a simple identifier (no dots)
4672
+ if (hookCallPath.includes('(') && !path.includes('.')) {
4673
+ // Special case: If hookCallPath is a callback scope (cyScope pattern),
4674
+ // trace through it to find what the callback actually returns.
4675
+ // This handles useState(() => { return prop; }) patterns.
4676
+ const cyScopeMatch = hookCallPath.match(/^(cyScope\d+)\(\)$/);
4677
+ if (cyScopeMatch) {
4678
+ // Use the equivalency database to trace the callback's return value
4679
+ // to its actual source (e.g., viewModeFromUrl -> segments -> params -> useParams)
4680
+ const dbEntry = this.getEquivalenciesDatabaseEntry(
4681
+ scopeNode.name, // Component scope
4682
+ path, // variable name (e.g., viewMode)
4683
+ );
4684
+ if (dbEntry?.sourceCandidates?.length > 0) {
4685
+ // Use the traced source instead of the callback scope
4686
+ hookCallPath = dbEntry.sourceCandidates[0].schemaPath;
4687
+ }
4688
+ }
4689
+ addEquivalency(path, hookCallPath);
4690
+ }
4691
+ }
3481
4692
 
3482
- getVariableInfo(
3483
- variableName: string,
3484
- scopeName?: string,
3485
- final?: boolean,
3486
- ): VariableInfo | undefined {
3487
- const scopeNode = this.getScopeOrFunctionCallInfo(
3488
- scopeName ?? this.scopeTreeManager.getRootName(),
3489
- );
3490
- if (!scopeNode) return;
4693
+ // Case 3: Destructured variables from local variables
4694
+ // e.g., const { scenarios } = currentEntityAnalysis;
4695
+ // This creates: path = "scenarios", schemaPath = "currentEntityAnalysis.scenarios"
4696
+ // We need to map: "scenarios" -> "currentEntityAnalysis.scenarios"
4697
+ // AND resolve transitively if currentEntityAnalysis is itself equivalent to a hook call
4698
+ if (
4699
+ !path.includes('.') && // path is a simple identifier
4700
+ !equivalentValue.schemaPath.startsWith('signature[') && // not a signature path
4701
+ !equivalentValue.schemaPath.endsWith('.functionCallReturnValue') // not already handled above
4702
+ ) {
4703
+ // Skip bare "returnValue" from child scopes — this is the child's return value,
4704
+ // not a meaningful data source path in the parent scope
4705
+ if (
4706
+ equivalentValue.schemaPath === 'returnValue' &&
4707
+ equivalentValue.scopeNodeName !==
4708
+ this.scopeTreeManager.getRootName()
4709
+ ) {
4710
+ continue;
4711
+ }
4712
+ // Add equivalency (will accumulate if multiple values for OR expressions)
4713
+ addEquivalency(path, equivalentValue.schemaPath);
4714
+ }
3491
4715
 
3492
- let equivalents = scopeNode.equivalencies[variableName];
4716
+ // Case 4: Child component prop mappings (Fix 22)
4717
+ // When parent renders <ChildComponent prop={value} />, we get equivalencies like:
4718
+ // path = "ChildComponent().signature[0].prop"
4719
+ // schemaPath = "value" (the variable passed as the prop)
4720
+ // We need to include these so translateChildPathToParent can work.
4721
+ // Pattern: ComponentName().signature[N] or ComponentName().signature[N].propName
4722
+ if (
4723
+ path.includes('().signature[') &&
4724
+ !equivalentValue.schemaPath.includes('()') // schemaPath is a simple variable, not a function call
4725
+ ) {
4726
+ addEquivalency(path, equivalentValue.schemaPath);
4727
+ }
4728
+
4729
+ // Case 5: Destructured function parameters (Fix 25)
4730
+ // When a function has destructured props: function Comp({ propA, propB }: Props)
4731
+ // We get equivalencies like:
4732
+ // path = "propA" (the destructured variable name)
4733
+ // schemaPath = "signature[0].propA" (the signature path)
4734
+ // We need to map: "propA" -> "signature[0].propA"
4735
+ // This enables translateChildPathToParent to resolve child variable paths
4736
+ // to their signature paths when merging execution flows.
4737
+ if (
4738
+ !path.includes('.') && // path is a simple identifier (destructured prop name)
4739
+ equivalentValue.schemaPath.startsWith('signature[') // schemaPath IS a signature path
4740
+ ) {
4741
+ addEquivalency(path, equivalentValue.schemaPath);
4742
+ }
4743
+
4744
+ // Case 7: Method calls on variables that result in .functionCallReturnValue (Fix 33)
4745
+ // When we have patterns like:
4746
+ // path = "segments" (simple identifier)
4747
+ // schemaPath = "splat.split('/').functionCallReturnValue"
4748
+ // This is a method call on a variable (not a hook call), but we still need to
4749
+ // track it so transitive resolution can resolve `splat` to its actual source.
4750
+ // E.g., if splat -> useParams().functionCallReturnValue['*'], then
4751
+ // segments -> useParams().functionCallReturnValue['*'].split('/').functionCallReturnValue
4752
+ if (
4753
+ !path.includes('.') && // path is a simple identifier
4754
+ equivalentValue.schemaPath.endsWith('.functionCallReturnValue') && // ends with function return
4755
+ equivalentValue.schemaPath.includes('.') // has property access (method call)
4756
+ ) {
4757
+ // Check if this looks like a method call on a variable (not a hook call)
4758
+ // Hook calls look like: hookName() or hookName<T>()
4759
+ // Method calls look like: variable.method() or variable.method<T>()
4760
+ const hookCallPath = equivalentValue.schemaPath.slice(
4761
+ 0,
4762
+ -'.functionCallReturnValue'.length,
4763
+ );
4764
+ // If it's a method call (contains a dot before the parenthesis), include it
4765
+ const dotBeforeParen = hookCallPath.indexOf('.');
4766
+ const parenPos = hookCallPath.indexOf('(');
4767
+ if (dotBeforeParen !== -1 && dotBeforeParen < parenPos) {
4768
+ // This is a method call like "splat.split('/')", not a hook call
4769
+ addEquivalency(path, equivalentValue.schemaPath);
4770
+ }
4771
+ }
4772
+ }
4773
+ }
4774
+
4775
+ // Case 6: Collect JSX child prop equivalencies from child scopes (Fix 26)
4776
+ // When a parent component renders <ChildComponent prop={value} />, the JSX
4777
+ // return statement may be in a child scope (e.g., cyScope2). The equivalencies
4778
+ // like ChildComponent().signature[0].prop -> value get stored in that child scope.
4779
+ // But translateChildPathToParent needs to find them from the parent scope's context.
4780
+ // So we collect Case 4 patterns from ALL child scopes that belong to this root scope.
4781
+ const rootName = this.scopeTreeManager.getRootName();
4782
+ for (const [scopeName, childScopeNode] of Object.entries(this.scopeNodes)) {
4783
+ // Skip the root scope (already processed above)
4784
+ if (scopeName === rootName) continue;
4785
+
4786
+ // Only include scopes that are children of the root (their tree includes root)
4787
+ if (!childScopeNode.tree?.includes(rootName)) continue;
4788
+
4789
+ // Look for Case 4 patterns in the child scope
4790
+ for (const [path, equivalentValues] of Object.entries(
4791
+ childScopeNode.equivalencies || {},
4792
+ )) {
4793
+ for (const equivalentValue of equivalentValues) {
4794
+ // Case 4 pattern: ChildComponent().signature[0].propName -> parentVariable
4795
+ if (
4796
+ path.includes('().signature[') &&
4797
+ !equivalentValue.schemaPath.includes('()') // schemaPath is a simple variable
4798
+ ) {
4799
+ // Only add if not already present from the root scope
4800
+ // Root scope values take precedence over child scope values
4801
+ if (!(path in equivalentSignatureVariables)) {
4802
+ addEquivalency(path, equivalentValue.schemaPath);
4803
+ }
4804
+ }
4805
+ }
4806
+ }
4807
+ }
4808
+
4809
+ // Transitive resolution: Resolve variable chains through multiple levels
4810
+ // E.g., analysis → currentEntityAnalysis → useLoaderData().functionCallReturnValue.currentEntityAnalysis
4811
+ // We need multiple passes because resolutions can depend on each other
4812
+ const maxIterations = 5; // Prevent infinite loops
4813
+
4814
+ // Helper function to resolve a single source path using equivalencies
4815
+ const resolveSourcePath = (
4816
+ sourcePath: string,
4817
+ equivMap: Record<string, string | string[]>,
4818
+ ): string | null => {
4819
+ // Extract base variable from the path
4820
+ const dotIndex = sourcePath.indexOf('.');
4821
+ const bracketIndex = sourcePath.indexOf('[');
4822
+
4823
+ let baseVar: string;
4824
+ let rest: string;
4825
+
4826
+ if (dotIndex === -1 && bracketIndex === -1) {
4827
+ baseVar = sourcePath;
4828
+ rest = '';
4829
+ } else if (dotIndex === -1) {
4830
+ baseVar = sourcePath.slice(0, bracketIndex);
4831
+ rest = sourcePath.slice(bracketIndex);
4832
+ } else if (bracketIndex === -1) {
4833
+ baseVar = sourcePath.slice(0, dotIndex);
4834
+ rest = sourcePath.slice(dotIndex);
4835
+ } else {
4836
+ const firstIndex = Math.min(dotIndex, bracketIndex);
4837
+ baseVar = sourcePath.slice(0, firstIndex);
4838
+ rest = sourcePath.slice(firstIndex);
4839
+ }
4840
+
4841
+ // Look up the base variable in equivalencies
4842
+ if (baseVar in equivMap && equivMap[baseVar] !== sourcePath) {
4843
+ const baseResolved = equivMap[baseVar];
4844
+ // Skip if baseResolved is an array (handle later)
4845
+ if (Array.isArray(baseResolved)) return null;
4846
+ // If it resolves to a signature path, build the full resolved path
4847
+ if (
4848
+ baseResolved.startsWith('signature[') ||
4849
+ baseResolved.includes('()')
4850
+ ) {
4851
+ if (baseResolved.endsWith('()')) {
4852
+ return baseResolved + '.functionCallReturnValue' + rest;
4853
+ }
4854
+ return baseResolved + rest;
4855
+ }
4856
+ }
4857
+ return null;
4858
+ };
4859
+
4860
+ for (let iteration = 0; iteration < maxIterations; iteration++) {
4861
+ let changed = false;
4862
+
4863
+ for (const [varName, sourcePathOrArray] of Object.entries(
4864
+ equivalentSignatureVariables,
4865
+ )) {
4866
+ // Handle arrays (OR expressions) by resolving each element
4867
+ if (Array.isArray(sourcePathOrArray)) {
4868
+ const resolvedArray: string[] = [];
4869
+ let arrayChanged = false;
4870
+ for (const sourcePath of sourcePathOrArray) {
4871
+ // Try to resolve this path using transitive resolution
4872
+ const resolved = resolveSourcePath(
4873
+ sourcePath,
4874
+ equivalentSignatureVariables,
4875
+ );
4876
+ if (resolved && resolved !== sourcePath) {
4877
+ resolvedArray.push(resolved);
4878
+ arrayChanged = true;
4879
+ } else {
4880
+ resolvedArray.push(sourcePath);
4881
+ }
4882
+ }
4883
+ if (arrayChanged) {
4884
+ equivalentSignatureVariables[varName] = resolvedArray;
4885
+ changed = true;
4886
+ }
4887
+ continue;
4888
+ }
4889
+ const sourcePath = sourcePathOrArray;
4890
+
4891
+ // Skip if already fully resolved (contains function call syntax)
4892
+ // BUT first check for computed value patterns that need resolution (Fix 28)
4893
+ // AND method call patterns that need base variable resolution (Fix 33)
4894
+ if (sourcePath.includes('()')) {
4895
+ // Fix 28: Handle computed value patterns with dependency arrays
4896
+ // Patterns like `functionName(arg, [dep1, dep2, ...])` are NOT controllable
4897
+ // data sources. We trace through the dependencies to find controllable sources.
4898
+ const bracketStart = sourcePath.indexOf('[');
4899
+ const bracketEnd = sourcePath.lastIndexOf(']');
4900
+
4901
+ if (bracketStart !== -1 && bracketEnd > bracketStart) {
4902
+ const arrayContent = sourcePath.slice(bracketStart + 1, bracketEnd);
4903
+ const items = arrayContent.split(',').map((s) => s.trim());
4904
+
4905
+ // Only process if this looks like a dependency array:
4906
+ // multiple items that are all simple identifiers (not numbers or expressions)
4907
+ const isIdentifier = (s: string) =>
4908
+ /^\w+$/.test(s) && !/^\d+$/.test(s);
4909
+ if (items.length > 1 && items.every(isIdentifier)) {
4910
+ // Look for a dependency that's already resolved to a controllable source
4911
+ for (const dep of items) {
4912
+ if (dep in equivalentSignatureVariables) {
4913
+ const resolvedDep = equivalentSignatureVariables[dep];
4914
+ // Use if it's a controllable path (contains hook call)
4915
+ // and is NOT another unresolved computed pattern (has comma-separated deps)
4916
+ const hasCommaInBrackets =
4917
+ resolvedDep.includes('[') &&
4918
+ resolvedDep.includes(',') &&
4919
+ resolvedDep.indexOf(',') > resolvedDep.indexOf('[');
4920
+ if (resolvedDep.includes('()') && !hasCommaInBrackets) {
4921
+ // Computed value is typically an element from an array
4922
+ equivalentSignatureVariables[varName] = resolvedDep + '[]';
4923
+ changed = true;
4924
+ break;
4925
+ }
4926
+ }
4927
+ }
4928
+ }
4929
+ }
4930
+
4931
+ // Fix 33: Handle method call patterns on variables
4932
+ // Patterns like: "splat.split('/').functionCallReturnValue"
4933
+ // We need to resolve the base variable (splat) to its actual source
4934
+ // Check if this is a method call on a variable (dot before first parenthesis)
4935
+ const dotIndex = sourcePath.indexOf('.');
4936
+ const parenIndex = sourcePath.indexOf('(');
4937
+ if (
4938
+ dotIndex !== -1 &&
4939
+ dotIndex < parenIndex &&
4940
+ !sourcePath.startsWith('use') // Not a hook call like useState()
4941
+ ) {
4942
+ // Extract the base variable (before the first dot)
4943
+ const baseVar = sourcePath.slice(0, dotIndex);
4944
+ const rest = sourcePath.slice(dotIndex); // includes ".method(...).functionCallReturnValue"
4945
+
4946
+ // Check if the base variable can be resolved
4947
+ if (
4948
+ baseVar in equivalentSignatureVariables &&
4949
+ baseVar !== varName
4950
+ ) {
4951
+ const baseResolved = equivalentSignatureVariables[baseVar];
4952
+ // Skip if baseResolved is an array (OR expression)
4953
+ if (Array.isArray(baseResolved)) continue;
4954
+ // Only resolve if the base resolved to something useful (contains () or .)
4955
+ if (baseResolved.includes('()') || baseResolved.includes('.')) {
4956
+ const newPath = baseResolved + rest;
4957
+ if (newPath !== equivalentSignatureVariables[varName]) {
4958
+ equivalentSignatureVariables[varName] = newPath;
4959
+ changed = true;
4960
+ }
4961
+ }
4962
+ }
4963
+ }
4964
+
4965
+ // Fix 38: Handle cyScope lazy initializer return values
4966
+ // When we have viewMode -> cyScope20(), trace through to find what cyScope20 returns.
4967
+ // The lazy initializer's return value should be the controllable data source.
4968
+ // Pattern: cyScopeN() where N is a number
4969
+ const cyScopeMatch = sourcePath.match(/^(cyScope\d+)\(\)$/);
4970
+ if (cyScopeMatch) {
4971
+ const cyScopeName = cyScopeMatch[1];
4972
+ const cyScopeNode = this.scopeNodes[cyScopeName];
4973
+
4974
+ if (cyScopeNode?.equivalencies) {
4975
+ // Look for returnValue equivalency in the cyScope
4976
+ const returnValueEquivs =
4977
+ cyScopeNode.equivalencies['returnValue'];
4978
+ if (returnValueEquivs && returnValueEquivs.length > 0) {
4979
+ // Get the first return value source
4980
+ const returnSource = returnValueEquivs[0].schemaPath;
4981
+
4982
+ // If the return source is a simple variable (not a complex path),
4983
+ // resolve varName directly to that variable
4984
+ if (
4985
+ returnSource &&
4986
+ !returnSource.includes('(') &&
4987
+ !returnSource.includes('[')
4988
+ ) {
4989
+ // Update varName to point to the return source
4990
+ if (equivalentSignatureVariables[varName] !== returnSource) {
4991
+ equivalentSignatureVariables[varName] = returnSource;
4992
+ changed = true;
4993
+ }
4994
+ }
4995
+ }
4996
+ }
4997
+ }
4998
+
4999
+ continue;
5000
+ }
5001
+
5002
+ // Check if the source path starts with a variable that's also in the map
5003
+ const dotIndex = sourcePath.indexOf('.');
5004
+ let baseVar: string;
5005
+ let rest: string;
5006
+
5007
+ if (dotIndex > 0) {
5008
+ // Path has a dot: "a.b.c" -> baseVar="a", rest=".b.c"
5009
+ baseVar = sourcePath.slice(0, dotIndex);
5010
+ rest = sourcePath.slice(dotIndex); // includes the leading dot
5011
+ } else {
5012
+ // Path is a simple identifier: "currentEntityAnalysis" -> baseVar="currentEntityAnalysis", rest=""
5013
+ baseVar = sourcePath;
5014
+ rest = '';
5015
+ }
5016
+
5017
+ if (baseVar in equivalentSignatureVariables && baseVar !== varName) {
5018
+ // Handle array case (OR expressions) - use first element
5019
+ const rawBaseResolved = equivalentSignatureVariables[baseVar];
5020
+ const baseResolved = Array.isArray(rawBaseResolved)
5021
+ ? rawBaseResolved[0]
5022
+ : rawBaseResolved;
5023
+ if (!baseResolved) continue;
5024
+ // If the base resolves to a hook call, add .functionCallReturnValue
5025
+ if (baseResolved.endsWith('()')) {
5026
+ const newPath = baseResolved + '.functionCallReturnValue' + rest;
5027
+ if (newPath !== equivalentSignatureVariables[varName]) {
5028
+ equivalentSignatureVariables[varName] = newPath;
5029
+ changed = true;
5030
+ }
5031
+ } else if (baseResolved !== sourcePath) {
5032
+ const newPath = baseResolved + rest;
5033
+ if (newPath !== equivalentSignatureVariables[varName]) {
5034
+ equivalentSignatureVariables[varName] = newPath;
5035
+ changed = true;
5036
+ }
5037
+ }
5038
+ }
5039
+ }
5040
+
5041
+ // Stop if no changes were made in this iteration
5042
+ if (!changed) break;
5043
+ }
5044
+
5045
+ return equivalentSignatureVariables;
5046
+ }
5047
+
5048
+ getVariableInfo(
5049
+ variableName: string,
5050
+ scopeName?: string,
5051
+ final?: boolean,
5052
+ ): VariableInfo | undefined {
5053
+ const scopeNode = this.getScopeOrFunctionCallInfo(
5054
+ scopeName ?? this.scopeTreeManager.getRootName(),
5055
+ );
5056
+ if (!scopeNode) return;
5057
+
5058
+ let equivalents = scopeNode.equivalencies[variableName];
3493
5059
 
3494
5060
  if (!equivalents || equivalents.length === 0) {
3495
5061
  equivalents = [
@@ -3526,7 +5092,12 @@ export class ScopeDataStructure {
3526
5092
  relevantSchema,
3527
5093
  );
3528
5094
 
5095
+ // CRITICAL: Set onlyEquivalencies to true to prevent database modifications
5096
+ // during this "getter" method. See comment in getFunctionSignature.
5097
+ const wasOnlyEquivalencies = this.onlyEquivalencies;
5098
+ this.onlyEquivalencies = true;
3529
5099
  this.validateSchema(tempScopeNode, true, final);
5100
+ this.onlyEquivalencies = wasOnlyEquivalencies;
3530
5101
 
3531
5102
  return {
3532
5103
  name: variableName,
@@ -3535,8 +5106,223 @@ export class ScopeDataStructure {
3535
5106
  };
3536
5107
  }
3537
5108
 
3538
- getExternalFunctionCalls() {
3539
- return this.externalFunctionCalls;
5109
+ getExternalFunctionCalls(): FunctionCallInfo[] {
5110
+ // Replace cyScope placeholders in all external function call data
5111
+ // This ensures call signatures and schema paths use actual callback text
5112
+ // instead of internal cyScope names, preventing mock data merge conflicts.
5113
+ const rootScopeName = this.scopeTreeManager.getRootName();
5114
+ const rootSchema = this.scopeNodes[rootScopeName]?.schema ?? {};
5115
+
5116
+ return this.externalFunctionCalls.map((efc) => {
5117
+ const cleaned = this.cleanCyScopeFromFunctionCallInfo(efc);
5118
+ return this.filterConflatedExternalPaths(cleaned, rootSchema);
5119
+ });
5120
+ }
5121
+
5122
+ /**
5123
+ * Filters out conflated paths from external function call schemas.
5124
+ *
5125
+ * When multiple useState(false) calls create equivalency conflation during
5126
+ * Phase 1 analysis, standalone boolean state variables (like showWorkoutForm,
5127
+ * showGoalForm) can bleed into external function call schemas as sub-properties
5128
+ * of unrelated data fields (like data[].activity_type.showWorkoutForm).
5129
+ *
5130
+ * Detection: group sub-properties by parent path. If 2+ sub-properties of
5131
+ * the same parent all match standalone root scope variable names, treat them
5132
+ * as conflation artifacts and remove them.
5133
+ */
5134
+ private filterConflatedExternalPaths(
5135
+ efc: FunctionCallInfo,
5136
+ rootSchema: Record<string, string>,
5137
+ ): FunctionCallInfo {
5138
+ // Build a set of top-level root scope variable names (simple names, no dots/brackets)
5139
+ const topLevelRootVars = new Set<string>();
5140
+ for (const key of Object.keys(rootSchema)) {
5141
+ if (!key.includes('.') && !key.includes('[')) {
5142
+ topLevelRootVars.add(key);
5143
+ }
5144
+ }
5145
+
5146
+ if (topLevelRootVars.size === 0) return efc;
5147
+
5148
+ // Group sub-property matches by their parent path.
5149
+ // For a path like "...data[].activity_type.showWorkoutForm",
5150
+ // parent = "...data[].activity_type", child = "showWorkoutForm"
5151
+ const parentToConflatedKeys = new Map<string, string[]>();
5152
+
5153
+ for (const key of Object.keys(efc.schema)) {
5154
+ const lastDot = key.lastIndexOf('.');
5155
+ if (lastDot === -1) continue;
5156
+
5157
+ const parent = key.substring(0, lastDot);
5158
+ const child = key.substring(lastDot + 1);
5159
+
5160
+ // Skip array access or function call patterns
5161
+ if (child.includes('[') || child.includes('(')) continue;
5162
+
5163
+ // Only consider paths inside array element chains (contains []).
5164
+ // Direct children of functionCallReturnValue are legitimate destructured
5165
+ // return values, not conflation. Conflation happens deeper in the chain
5166
+ // when array element fields get corrupted sub-properties.
5167
+ if (!parent.includes('[')) continue;
5168
+
5169
+ if (topLevelRootVars.has(child)) {
5170
+ if (!parentToConflatedKeys.has(parent)) {
5171
+ parentToConflatedKeys.set(parent, []);
5172
+ }
5173
+ parentToConflatedKeys.get(parent)!.push(key);
5174
+ }
5175
+ }
5176
+
5177
+ // Only filter when 2+ sub-properties of the same parent match root scope vars.
5178
+ // This threshold avoids false positives from coincidental name matches.
5179
+ const keysToRemove = new Set<string>();
5180
+ const parentsToRestore = new Set<string>();
5181
+
5182
+ for (const [parent, conflatedKeys] of parentToConflatedKeys) {
5183
+ if (conflatedKeys.length >= 2) {
5184
+ for (const key of conflatedKeys) {
5185
+ keysToRemove.add(key);
5186
+ }
5187
+ parentsToRestore.add(parent);
5188
+ }
5189
+ }
5190
+
5191
+ if (keysToRemove.size === 0) return efc;
5192
+
5193
+ // Create a new schema without the conflated paths
5194
+ const newSchema: Record<string, string> = {};
5195
+ for (const [key, value] of Object.entries(efc.schema)) {
5196
+ if (keysToRemove.has(key)) continue;
5197
+
5198
+ // Restore parent type: if it was changed to "object" because of conflated
5199
+ // sub-properties, and now all those sub-properties are removed, change it
5200
+ // back to "unknown" (we don't know the original type)
5201
+ if (parentsToRestore.has(key) && value === 'object') {
5202
+ // Check if there are any remaining sub-properties
5203
+ const hasRemainingSubProps = Object.keys(efc.schema).some(
5204
+ (k) =>
5205
+ !keysToRemove.has(k) &&
5206
+ k !== key &&
5207
+ (k.startsWith(key + '.') || k.startsWith(key + '[')),
5208
+ );
5209
+ newSchema[key] = hasRemainingSubProps ? value : 'unknown';
5210
+ } else {
5211
+ newSchema[key] = value;
5212
+ }
5213
+ }
5214
+
5215
+ return { ...efc, schema: newSchema };
5216
+ }
5217
+
5218
+ /**
5219
+ * Cleans cyScope placeholder references from a FunctionCallInfo.
5220
+ * Replaces cyScopeN() with the actual callback text in:
5221
+ * - callSignature
5222
+ * - allCallSignatures
5223
+ * - schema keys
5224
+ */
5225
+ private cleanCyScopeFromFunctionCallInfo(
5226
+ efc: FunctionCallInfo,
5227
+ ): FunctionCallInfo {
5228
+ const cyScopePattern = /cyScope\d+\(\)/g;
5229
+
5230
+ // Check if any cleaning is needed
5231
+ const hasCyScope =
5232
+ cyScopePattern.test(efc.callSignature) ||
5233
+ (efc.allCallSignatures &&
5234
+ efc.allCallSignatures.some((sig) => /cyScope\d+\(\)/.test(sig))) ||
5235
+ (efc.schema &&
5236
+ Object.keys(efc.schema).some((key) => /cyScope\d+\(\)/.test(key)));
5237
+
5238
+ if (!hasCyScope) {
5239
+ return efc;
5240
+ }
5241
+
5242
+ // Create cleaned copy
5243
+ const cleaned: FunctionCallInfo = { ...efc };
5244
+
5245
+ // Clean callSignature
5246
+ cleaned.callSignature = this.replaceCyScopeInString(efc.callSignature);
5247
+
5248
+ // Clean allCallSignatures
5249
+ if (efc.allCallSignatures) {
5250
+ cleaned.allCallSignatures = efc.allCallSignatures.map((sig) =>
5251
+ this.replaceCyScopeInString(sig),
5252
+ );
5253
+ }
5254
+
5255
+ // Clean schema keys
5256
+ if (efc.schema) {
5257
+ cleaned.schema = this.replaceCyScopePlaceholders(efc.schema);
5258
+ }
5259
+
5260
+ // Clean callSignatureToVariable keys
5261
+ if (efc.callSignatureToVariable) {
5262
+ cleaned.callSignatureToVariable = Object.entries(
5263
+ efc.callSignatureToVariable,
5264
+ ).reduce(
5265
+ (acc, [key, value]) => {
5266
+ acc[this.replaceCyScopeInString(key)] = value;
5267
+ return acc;
5268
+ },
5269
+ {} as Record<string, string>,
5270
+ );
5271
+ }
5272
+
5273
+ return cleaned;
5274
+ }
5275
+
5276
+ /**
5277
+ * Replaces cyScope placeholder references in a single string.
5278
+ * If the scope text can't be found, uses a generic fallback to avoid leaking
5279
+ * internal cyScope names into stored data.
5280
+ *
5281
+ * Handles two patterns:
5282
+ * 1. Function call style: cyScope7() - matched by cyScope(\d+)\(\)
5283
+ * 2. Scope name style: parentName____cyScopeXX or cyScopeXX - matched by (\w+____)?cyScope([0-9A-Fa-f]+)
5284
+ */
5285
+ private replaceCyScopeInString(str: string): string {
5286
+ let result = str;
5287
+
5288
+ // Pattern 1: Function call style - cyScope7()
5289
+ const functionCallPattern = /cyScope(\d+)\(\)/g;
5290
+ const functionCallMatches = [...str.matchAll(functionCallPattern)];
5291
+ for (const match of functionCallMatches) {
5292
+ const cyScopeName = `cyScope${match[1]}`;
5293
+ const scopeText = this.findCyScopeText(cyScopeName);
5294
+ // Always replace cyScope references - use actual text if available,
5295
+ // otherwise use a generic callback placeholder
5296
+ const replacement = scopeText || '() => {}';
5297
+ result = result.replace(match[0], replacement);
5298
+ }
5299
+
5300
+ // Pattern 2: Scope name style - parentName____cyScopeXX or just cyScopeXX
5301
+ // This handles hex-encoded scope IDs like cyScope1F
5302
+ const scopeNamePattern = /(\w+____)?cyScope([0-9A-Fa-f]+)/g;
5303
+ const scopeNameMatches = [...result.matchAll(scopeNamePattern)];
5304
+ for (const match of scopeNameMatches) {
5305
+ const fullMatch = match[0];
5306
+ const prefix = match[1] || ''; // e.g., "getTitleColor____"
5307
+ const cyScopeId = match[2]; // e.g., "1F"
5308
+ const cyScopeName = `cyScope${cyScopeId}`;
5309
+
5310
+ // Try to find the scope text, checking both with and without prefix
5311
+ let scopeText = this.findCyScopeText(cyScopeName);
5312
+ if (!scopeText && prefix) {
5313
+ // Try looking up with the full prefixed name
5314
+ scopeText = this.findCyScopeText(`${prefix}${cyScopeName}`);
5315
+ }
5316
+
5317
+ if (scopeText) {
5318
+ result = result.replace(fullMatch, scopeText);
5319
+ } else {
5320
+ // Replace with a generic identifier to avoid leaking internal names
5321
+ result = result.replace(fullMatch, 'callback');
5322
+ }
5323
+ }
5324
+
5325
+ return result;
3540
5326
  }
3541
5327
 
3542
5328
  getEnvironmentVariables() {
@@ -3554,7 +5340,7 @@ export class ScopeDataStructure {
3554
5340
  path: string;
3555
5341
  conditionType: 'truthiness' | 'comparison' | 'switch';
3556
5342
  comparedValues?: string[];
3557
- location: 'if' | 'ternary' | 'logical-and' | 'switch';
5343
+ location: 'if' | 'ternary' | 'logical-and' | 'switch' | 'unconditional';
3558
5344
  }>
3559
5345
  >,
3560
5346
  ): void {
@@ -3579,29 +5365,149 @@ export class ScopeDataStructure {
3579
5365
  }
3580
5366
 
3581
5367
  /**
3582
- * Get enriched conditional usages with source tracing.
3583
- * Uses explainPath to trace each local variable back to its data source.
5368
+ * Add conditional effects from AST analysis.
5369
+ * Called during scope analysis to collect all setter calls inside conditionals.
5370
+ */
5371
+ addConditionalEffects(
5372
+ effects: import('../astScopes/types').ConditionalEffect[],
5373
+ ): void {
5374
+ // Add effects, avoiding duplicates based on effect stateVariable and condition paths
5375
+ for (const effect of effects) {
5376
+ const exists = this.rawConditionalEffects.some((existing) => {
5377
+ // Same effect target (stateVariable + value)
5378
+ const sameEffect =
5379
+ existing.effect.stateVariable === effect.effect.stateVariable &&
5380
+ existing.effect.value === effect.effect.value;
5381
+ if (!sameEffect) return false;
5382
+
5383
+ // Same condition(s)
5384
+ if (existing.condition && effect.condition) {
5385
+ return (
5386
+ existing.condition.path === effect.condition.path &&
5387
+ existing.condition.requiredValue === effect.condition.requiredValue
5388
+ );
5389
+ }
5390
+ if (existing.conditions && effect.conditions) {
5391
+ if (existing.conditions.length !== effect.conditions.length)
5392
+ return false;
5393
+ return existing.conditions.every((ec, i) => {
5394
+ const newCond = effect.conditions![i];
5395
+ return (
5396
+ ec.path === newCond.path &&
5397
+ ec.requiredValue === newCond.requiredValue
5398
+ );
5399
+ });
5400
+ }
5401
+ return false;
5402
+ });
5403
+ if (!exists) {
5404
+ this.rawConditionalEffects.push(effect);
5405
+ }
5406
+ }
5407
+ }
5408
+
5409
+ /**
5410
+ * Get conditional effects collected during analysis.
5411
+ */
5412
+ getConditionalEffects(): import('../astScopes/types').ConditionalEffect[] {
5413
+ return this.rawConditionalEffects;
5414
+ }
5415
+
5416
+ /**
5417
+ * Add compound conditionals from AST analysis.
5418
+ * Called during scope analysis to collect grouped conditions (e.g., a && b && c).
5419
+ */
5420
+ addCompoundConditionals(
5421
+ compounds: import('../astScopes/types').CompoundConditional[],
5422
+ ): void {
5423
+ // Add compounds, avoiding duplicates based on chainId
5424
+ for (const compound of compounds) {
5425
+ const exists = this.rawCompoundConditionals.some(
5426
+ (existing) => existing.chainId === compound.chainId,
5427
+ );
5428
+ if (!exists) {
5429
+ this.rawCompoundConditionals.push(compound);
5430
+ }
5431
+ }
5432
+ }
5433
+
5434
+ /**
5435
+ * Get compound conditionals collected during analysis.
5436
+ */
5437
+ getCompoundConditionals(): import('../astScopes/types').CompoundConditional[] {
5438
+ return this.rawCompoundConditionals;
5439
+ }
5440
+
5441
+ /**
5442
+ * Add child boundary gating conditions from AST analysis.
5443
+ * These track which conditions must be true for a child component to render.
5444
+ */
5445
+ addChildBoundaryGatingConditions(
5446
+ conditions: Record<string, import('../astScopes/types').ConditionalUsage[]>,
5447
+ ): void {
5448
+ for (const [childName, usages] of Object.entries(conditions)) {
5449
+ if (!this.rawChildBoundaryGatingConditions[childName]) {
5450
+ this.rawChildBoundaryGatingConditions[childName] = [];
5451
+ }
5452
+ // Add usages, avoiding duplicates
5453
+ for (const usage of usages) {
5454
+ const exists = this.rawChildBoundaryGatingConditions[childName].some(
5455
+ (existing) =>
5456
+ existing.path === usage.path &&
5457
+ existing.conditionType === usage.conditionType &&
5458
+ existing.isNegated === usage.isNegated,
5459
+ );
5460
+ if (!exists) {
5461
+ this.rawChildBoundaryGatingConditions[childName].push(usage);
5462
+ }
5463
+ }
5464
+ }
5465
+ }
5466
+
5467
+ /**
5468
+ * Get enriched child boundary gating conditions with source tracing.
5469
+ * Similar to getEnrichedConditionalUsages but for gating conditions.
3584
5470
  */
3585
- getEnrichedConditionalUsages(): Record<
5471
+ getEnrichedChildBoundaryGatingConditions(): Record<
3586
5472
  string,
3587
- Array<{
3588
- path: string;
3589
- conditionType: 'truthiness' | 'comparison' | 'switch';
3590
- comparedValues?: string[];
3591
- location: 'if' | 'ternary' | 'logical-and' | 'switch';
3592
- sourceDataPath?: string;
3593
- }>
5473
+ EnrichedConditionalUsage[]
3594
5474
  > {
3595
- const enriched: Record<
3596
- string,
3597
- Array<{
3598
- path: string;
3599
- conditionType: 'truthiness' | 'comparison' | 'switch';
3600
- comparedValues?: string[];
3601
- location: 'if' | 'ternary' | 'logical-and' | 'switch';
3602
- sourceDataPath?: string;
3603
- }>
3604
- > = {};
5475
+ const enriched: Record<string, EnrichedConditionalUsage[]> = {};
5476
+ const rootScopeName = this.scopeTreeManager.getTree().name;
5477
+
5478
+ for (const [childName, usages] of Object.entries(
5479
+ this.rawChildBoundaryGatingConditions,
5480
+ )) {
5481
+ enriched[childName] = usages.map((usage) => {
5482
+ // Try to trace this path back to a data source
5483
+ const explanation = this.explainPath(rootScopeName, usage.path);
5484
+
5485
+ let sourceDataPath: string | undefined;
5486
+ if (explanation.source) {
5487
+ sourceDataPath = `${explanation.source.scope}.${explanation.source.path}`;
5488
+ }
5489
+
5490
+ return {
5491
+ ...usage,
5492
+ sourceDataPath,
5493
+ };
5494
+ });
5495
+ }
5496
+
5497
+ return enriched;
5498
+ }
5499
+
5500
+ /**
5501
+ * Get enriched conditional usages with source tracing.
5502
+ * Uses explainPath to trace each local variable back to its data source.
5503
+ * Preserves all fields from the raw conditional usages including derivedFrom.
5504
+ */
5505
+ getEnrichedConditionalUsages(): Record<string, EnrichedConditionalUsage[]> {
5506
+ const enriched: Record<string, EnrichedConditionalUsage[]> = {};
5507
+
5508
+ console.log(
5509
+ `[getEnrichedConditionalUsages] Processing ${Object.keys(this.rawConditionalUsages).length} conditional paths: [${Object.keys(this.rawConditionalUsages).join(', ')}]`,
5510
+ );
3605
5511
 
3606
5512
  for (const [path, usages] of Object.entries(this.rawConditionalUsages)) {
3607
5513
  // Try to trace this path back to a data source
@@ -3611,10 +5517,69 @@ export class ScopeDataStructure {
3611
5517
 
3612
5518
  let sourceDataPath: string | undefined;
3613
5519
  if (explanation.source) {
3614
- // Build the full data path: scopeName.path
3615
- sourceDataPath = `${explanation.source.scope}.${explanation.source.path}`;
5520
+ const { scope, path: sourcePath } = explanation.source;
5521
+
5522
+ // Build initial path — avoid redundant prefix when path already contains the scope call
5523
+ let fullPath: string;
5524
+ if (sourcePath.startsWith(`${scope}(`)) {
5525
+ fullPath = sourcePath;
5526
+ } else {
5527
+ fullPath = `${scope}.${sourcePath}`;
5528
+ }
5529
+
5530
+ sourceDataPath = fullPath;
5531
+ console.log(
5532
+ `[getEnrichedConditionalUsages] "${path}" explainPath → scope="${scope}", sourcePath="${sourcePath}" → sourceDataPath="${sourceDataPath}"`,
5533
+ );
5534
+ } else {
5535
+ console.log(
5536
+ `[getEnrichedConditionalUsages] "${path}" explainPath → no source found`,
5537
+ );
5538
+ }
5539
+
5540
+ // If explainPath didn't find a useful external source (e.g., it traced to
5541
+ // useState or just to the component scope itself), check sourceEquivalencies
5542
+ // for an external function call source like a fetch call
5543
+ const hasExternalSource = sourceDataPath?.includes(
5544
+ '.functionCallReturnValue',
5545
+ );
5546
+ if (!hasExternalSource) {
5547
+ console.log(
5548
+ `[getEnrichedConditionalUsages] "${path}" no external source (sourceDataPath="${sourceDataPath}"), checking sourceEquivalencies fallback...`,
5549
+ );
5550
+ const sourceEquiv = this.getSourceEquivalencies();
5551
+ const returnValueKey = `returnValue.${path}`;
5552
+ const sources = sourceEquiv[returnValueKey];
5553
+ if (sources) {
5554
+ console.log(
5555
+ `[getEnrichedConditionalUsages] "${path}" sourceEquivalencies["${returnValueKey}"] has ${sources.length} sources: [${sources.map((s: { schemaPath: string }) => s.schemaPath).join(', ')}]`,
5556
+ );
5557
+ const externalSource = sources.find(
5558
+ (s: { schemaPath: string }) =>
5559
+ s.schemaPath.includes('.functionCallReturnValue') &&
5560
+ !s.schemaPath.startsWith('useState('),
5561
+ );
5562
+ if (externalSource) {
5563
+ console.log(
5564
+ `[getEnrichedConditionalUsages] "${path}" sourceEquivalencies fallback found external source: "${externalSource.schemaPath}"`,
5565
+ );
5566
+ sourceDataPath = externalSource.schemaPath;
5567
+ } else {
5568
+ console.log(
5569
+ `[getEnrichedConditionalUsages] "${path}" sourceEquivalencies fallback found no external function call source`,
5570
+ );
5571
+ }
5572
+ } else {
5573
+ console.log(
5574
+ `[getEnrichedConditionalUsages] "${path}" sourceEquivalencies["${returnValueKey}"] not found`,
5575
+ );
5576
+ }
3616
5577
  }
3617
5578
 
5579
+ console.log(
5580
+ `[getEnrichedConditionalUsages] "${path}" FINAL sourceDataPath="${sourceDataPath ?? '(none)'}" (${usages.length} usages)`,
5581
+ );
5582
+
3618
5583
  enriched[path] = usages.map((usage) => ({
3619
5584
  ...usage,
3620
5585
  sourceDataPath,
@@ -3624,35 +5589,86 @@ export class ScopeDataStructure {
3624
5589
  return enriched;
3625
5590
  }
3626
5591
 
5592
+ /**
5593
+ * Add JSX rendering usages from AST analysis.
5594
+ * These track arrays rendered via .map() and strings interpolated in JSX.
5595
+ */
5596
+ addJsxRenderingUsages(
5597
+ usages: import('../astScopes/types').JsxRenderingUsage[],
5598
+ ): void {
5599
+ // Add usages, avoiding duplicates based on path and renderingType
5600
+ for (const usage of usages) {
5601
+ const exists = this.rawJsxRenderingUsages.some(
5602
+ (existing) =>
5603
+ existing.path === usage.path &&
5604
+ existing.renderingType === usage.renderingType,
5605
+ );
5606
+ if (!exists) {
5607
+ this.rawJsxRenderingUsages.push(usage);
5608
+ }
5609
+ }
5610
+ }
5611
+
5612
+ /**
5613
+ * Get JSX rendering usages collected during analysis.
5614
+ */
5615
+ getJsxRenderingUsages(): import('../astScopes/types').JsxRenderingUsage[] {
5616
+ return this.rawJsxRenderingUsages;
5617
+ }
5618
+
3627
5619
  toSerializable(): SerializableDataStructure {
3628
- // Helper to convert ScopeVariable to SerializableScopeVariable
5620
+ // Helper to clean cyScope and cyDuplicateKey from a string for output
5621
+ const cleanCyScope = (str: string): string =>
5622
+ this.replaceCyScopeInString(str).replace(/::cyDuplicateKey\d+::/g, '');
5623
+
5624
+ // Helper to convert ScopeVariable to SerializableScopeVariable (with cyScope cleaned)
3629
5625
  const toSerializableVariable = (
3630
5626
  vars:
3631
5627
  | ScopeVariable[]
3632
5628
  | Pick<ScopeVariable, 'scopeNodeName' | 'schemaPath'>[],
3633
5629
  ): SerializableScopeVariable[] =>
3634
5630
  vars.map((v) => ({
3635
- scopeNodeName: v.scopeNodeName,
3636
- schemaPath: v.schemaPath,
5631
+ scopeNodeName: cleanCyScope(v.scopeNodeName),
5632
+ schemaPath: cleanCyScope(v.schemaPath),
3637
5633
  }));
3638
5634
 
5635
+ // Helper to clean cyScope from all keys in a schema
5636
+ const cleanSchemaKeys = (
5637
+ schema: Record<string, string>,
5638
+ ): Record<string, string> => {
5639
+ return Object.entries(schema).reduce(
5640
+ (acc, [key, value]) => {
5641
+ acc[cleanCyScope(key)] = value;
5642
+ return acc;
5643
+ },
5644
+ {} as Record<string, string>,
5645
+ );
5646
+ };
5647
+
3639
5648
  // Helper to get function result for a given function name
3640
5649
  const getFunctionResult = (
3641
5650
  functionName?: string,
3642
5651
  ): SerializableFunctionResult => {
3643
5652
  return {
3644
- signature: this.getFunctionSignature({ functionName }) ?? {},
3645
- signatureWithUnknowns:
5653
+ signature: cleanSchemaKeys(
5654
+ this.getFunctionSignature({ functionName }) ?? {},
5655
+ ),
5656
+ signatureWithUnknowns: cleanSchemaKeys(
3646
5657
  this.getFunctionSignature({ functionName, fillInUnknowns: true }) ??
3647
- {},
3648
- returnValue: this.getReturnValue({ functionName }) ?? {},
3649
- returnValueWithUnknowns:
5658
+ {},
5659
+ ),
5660
+ returnValue: cleanSchemaKeys(
5661
+ this.getReturnValue({ functionName }) ?? {},
5662
+ ),
5663
+ returnValueWithUnknowns: cleanSchemaKeys(
3650
5664
  this.getReturnValue({ functionName, fillInUnknowns: true }) ?? {},
5665
+ ),
3651
5666
  usageEquivalencies: Object.entries(
3652
5667
  this.getUsageEquivalencies(functionName) ?? {},
3653
5668
  ).reduce(
3654
5669
  (acc, [key, vars]) => {
3655
- acc[key] = toSerializableVariable(vars);
5670
+ // Clean cyScope from the key as well as variable properties
5671
+ acc[cleanCyScope(key)] = toSerializableVariable(vars);
3656
5672
  return acc;
3657
5673
  },
3658
5674
  {} as Record<string, SerializableScopeVariable[]>,
@@ -3661,7 +5677,8 @@ export class ScopeDataStructure {
3661
5677
  this.getSourceEquivalencies(functionName) ?? {},
3662
5678
  ).reduce(
3663
5679
  (acc, [key, vars]) => {
3664
- acc[key] = toSerializableVariable(vars);
5680
+ // Clean cyScope from the key as well as variable properties
5681
+ acc[cleanCyScope(key)] = toSerializableVariable(vars);
3665
5682
  return acc;
3666
5683
  },
3667
5684
  {} as Record<string, SerializableScopeVariable[]>,
@@ -3670,39 +5687,417 @@ export class ScopeDataStructure {
3670
5687
  };
3671
5688
  };
3672
5689
 
3673
- // Convert external function calls
5690
+ // Convert external function calls - use getExternalFunctionCalls() which cleans cyScope
5691
+ const cleanedExternalCalls = this.getExternalFunctionCalls();
5692
+
5693
+ // Get root scope schema for building per-variable return value schemas
5694
+ const rootScopeName = this.scopeTreeManager.getRootName();
5695
+ const rootScope = this.scopeNodes[rootScopeName];
5696
+ const rootSchema = rootScope?.schema ?? {};
5697
+
3674
5698
  const externalFunctionCalls: SerializableFunctionCallInfo[] =
3675
- this.externalFunctionCalls.map((efc) => ({
3676
- name: efc.name,
3677
- callSignature: efc.callSignature,
3678
- callScope: efc.callScope,
3679
- schema: efc.schema,
3680
- equivalencies: efc.equivalencies
3681
- ? Object.entries(efc.equivalencies).reduce(
3682
- (acc, [key, vars]) => {
3683
- acc[key] = toSerializableVariable(vars);
3684
- return acc;
3685
- },
3686
- {} as Record<string, SerializableScopeVariable[]>,
3687
- )
3688
- : undefined,
3689
- allCallSignatures: efc.allCallSignatures,
3690
- receivingVariableNames: efc.receivingVariableNames,
3691
- callSignatureToVariable: efc.callSignatureToVariable,
3692
- }));
5699
+ cleanedExternalCalls.map((efc) => {
5700
+ // Build perVariableSchemas from perCallSignatureSchemas when available.
5701
+ // This preserves distinct schemas per variable when the same function is called
5702
+ // multiple times with DIFFERENT call signatures (e.g., different type parameters).
5703
+ //
5704
+ // When field accesses happen in child scopes (like JSX expressions), the
5705
+ // rootSchema doesn't contain the detailed paths - they end up in child scope
5706
+ // schemas. Using perCallSignatureSchemas ensures we get the correct schema
5707
+ // for each call, regardless of where field accesses occur.
5708
+ let perVariableSchemas:
5709
+ | Record<string, Record<string, string>>
5710
+ | undefined;
5711
+
5712
+ // Use perCallSignatureSchemas only when:
5713
+ // 1. It exists and has distinct entries for different call signatures
5714
+ // 2. The number of distinct call signatures >= number of receiving variables
5715
+ //
5716
+ // This prevents using it when all calls have the same signature (e.g., useFetcher() x 2)
5717
+ // because in that case, perCallSignatureSchemas only has one entry.
5718
+ const numCallSignatures = efc.perCallSignatureSchemas
5719
+ ? Object.keys(efc.perCallSignatureSchemas).length
5720
+ : 0;
5721
+ const numReceivingVars = efc.receivingVariableNames?.length ?? 0;
5722
+ const hasDistinctSchemas =
5723
+ numCallSignatures >= numReceivingVars && numCallSignatures > 1;
5724
+
5725
+ // CASE 1: Multiple call signatures with distinct schemas - use indexed variable names
5726
+ if (
5727
+ hasDistinctSchemas &&
5728
+ efc.perCallSignatureSchemas &&
5729
+ efc.callSignatureToVariable
5730
+ ) {
5731
+ perVariableSchemas = {};
5732
+
5733
+ // Build a reverse map: variable -> array of call signatures (in order)
5734
+ // This handles the case where the same variable name is reused for different calls
5735
+ const varToCallSigs: Record<string, string[]> = {};
5736
+ for (const [callSig, varName] of Object.entries(
5737
+ efc.callSignatureToVariable,
5738
+ )) {
5739
+ if (!varToCallSigs[varName]) {
5740
+ varToCallSigs[varName] = [];
5741
+ }
5742
+ varToCallSigs[varName].push(callSig);
5743
+ }
5744
+
5745
+ // Track how many times each variable name has been seen
5746
+ const varNameCounts: Record<string, number> = {};
5747
+
5748
+ // For each receiving variable, get its original schema from perCallSignatureSchemas
5749
+ for (const varName of efc.receivingVariableNames ?? []) {
5750
+ const occurrence = varNameCounts[varName] ?? 0;
5751
+ varNameCounts[varName] = occurrence + 1;
5752
+
5753
+ const callSigs = varToCallSigs[varName];
5754
+ // Use the nth call signature for the nth occurrence of this variable
5755
+ const callSig = callSigs?.[occurrence];
5756
+
5757
+ if (callSig && efc.perCallSignatureSchemas[callSig]) {
5758
+ // Use indexed key if this variable name is reused (e.g., fetcher, fetcher[1])
5759
+ const key =
5760
+ occurrence === 0 ? varName : `${varName}[${occurrence}]`;
5761
+ // Clone the schema to avoid shared references
5762
+ perVariableSchemas[key] = {
5763
+ ...efc.perCallSignatureSchemas[callSig],
5764
+ };
5765
+ }
5766
+ }
5767
+
5768
+ // Only include if we have entries for ALL receiving variables
5769
+ if (Object.keys(perVariableSchemas).length < numReceivingVars) {
5770
+ // Not all variables have schemas - fall back to rootSchema extraction
5771
+ perVariableSchemas = undefined;
5772
+ } else {
5773
+ // Also check that at least one schema is non-empty
5774
+ // Bug fix: perCallSignatureSchemas may have entries but with empty schemas {}
5775
+ // In this case, we should fall through to Fallback which uses rootSchema
5776
+ const hasNonEmptySchema = Object.values(perVariableSchemas).some(
5777
+ (schema) => Object.keys(schema).length > 0,
5778
+ );
5779
+ if (!hasNonEmptySchema) {
5780
+ perVariableSchemas = undefined;
5781
+ }
5782
+ }
5783
+ }
5784
+
5785
+ // CASE 2: Single call signature with single variable - use perCallSignatureSchemas directly
5786
+ // This handles parameterized calls like useFetcher<ConfigData>() where each is a separate efc entry
5787
+ if (
5788
+ !perVariableSchemas &&
5789
+ efc.perCallSignatureSchemas &&
5790
+ numCallSignatures === 1 &&
5791
+ numReceivingVars === 1
5792
+ ) {
5793
+ const varName = efc.receivingVariableNames![0];
5794
+ const callSig = Object.keys(efc.perCallSignatureSchemas)[0];
5795
+ const schema = efc.perCallSignatureSchemas[callSig];
5796
+ if (schema && Object.keys(schema).length > 0) {
5797
+ perVariableSchemas = { [varName]: { ...schema } };
5798
+ }
5799
+ }
5800
+
5801
+ // CASE 3: Extract from efc.schema when perCallSignatureSchemas is missing or empty
5802
+ // This handles two scenarios:
5803
+ // 1. Parameterized calls that create SEPARATE efc entries (no perCallSignatureSchemas)
5804
+ // 2. Destructuring where perCallSignatureSchemas exists but has EMPTY schemas
5805
+ //
5806
+ // When useFetcher<ConfigData>() and useFetcher<SettingsData>() are called, they create separate
5807
+ // efc entries because getFunctionCallRoot preserves type parameters. Each entry has its own
5808
+ // `schema` field, but due to variable reassignment, the schema may be contaminated with paths
5809
+ // from other calls (the tracer attributes field accesses to ALL equivalencies).
5810
+ //
5811
+ // Solution: Filter efc.schema to only include paths that match THIS entry's call signature.
5812
+ // The schema paths include the full call signature prefix, so we can filter by it.
5813
+ //
5814
+ // Example: ConfigData entry has paths like:
5815
+ // "useFetcher<{ data: ConfigData | null }>().functionCallReturnValue.data.data.theme"
5816
+ // But also (contaminated):
5817
+ // "useFetcher<{ data: ConfigData | null }>().functionCallReturnValue.data.data.notifications"
5818
+ //
5819
+ // We filter to only keep paths that should belong to THIS call by checking if the
5820
+ // receiving variable's equivalency points to this call's return value.
5821
+ //
5822
+ // BUG FIX: The old condition `!efc.perCallSignatureSchemas` was FALSE when the object
5823
+ // existed (even with empty schemas), causing this case to be skipped. We now also check
5824
+ // if all schemas in perCallSignatureSchemas are empty.
5825
+ const hasNonEmptyPerCallSignatureSchemas =
5826
+ efc.perCallSignatureSchemas &&
5827
+ Object.values(efc.perCallSignatureSchemas).some(
5828
+ (schema) => Object.keys(schema).length > 0,
5829
+ );
5830
+
5831
+ // Build the call signature prefix that paths should start with
5832
+ const callSigPrefix = `${efc.callSignature}.functionCallReturnValue`;
5833
+
5834
+ // Check if efc.schema has variable-specific paths (indicating destructuring).
5835
+ // Destructuring: const { entities, gitStatus } = useLoaderData()
5836
+ // - efc.schema has paths like: useLoaderData().functionCallReturnValue.entities...
5837
+ // Multiple calls: const x = useFetcher(); const y = useFetcher();
5838
+ // - efc.schema has paths like: useFetcher().functionCallReturnValue.data...
5839
+ // CASE 3 should only run for destructuring (variable-specific paths exist).
5840
+ const hasVariableSpecificPaths = (
5841
+ efc.receivingVariableNames ?? []
5842
+ ).some((varName) =>
5843
+ Object.keys(efc.schema).some((path) =>
5844
+ path.startsWith(`${callSigPrefix}.${varName}`),
5845
+ ),
5846
+ );
5847
+
5848
+ if (
5849
+ !perVariableSchemas &&
5850
+ !hasNonEmptyPerCallSignatureSchemas &&
5851
+ numReceivingVars >= 1 &&
5852
+ hasVariableSpecificPaths
5853
+ ) {
5854
+ // Filter efc.schema to only include paths matching this call signature
5855
+ const filteredSchema: Record<string, string> = {};
5856
+ for (const [path, type] of Object.entries(efc.schema)) {
5857
+ if (path.startsWith(callSigPrefix) || path === efc.callSignature) {
5858
+ filteredSchema[path] = type;
5859
+ }
5860
+ }
5861
+
5862
+ // Build perVariableSchemas from the filtered schema
5863
+ // For destructuring, filter paths by variable name
5864
+ if (Object.keys(filteredSchema).length > 0) {
5865
+ perVariableSchemas = {};
5866
+ for (const varName of efc.receivingVariableNames ?? []) {
5867
+ // For destructuring, extract only paths specific to this variable
5868
+ const varSpecificPrefix = `${callSigPrefix}.${varName}`;
5869
+ const varSchema: Record<string, string> = {};
5870
+
5871
+ for (const [path, type] of Object.entries(filteredSchema)) {
5872
+ if (path.startsWith(varSpecificPrefix)) {
5873
+ // Transform: useLoaderData().functionCallReturnValue.entities.sha
5874
+ // -> functionCallReturnValue.entities.sha (keep the variable name)
5875
+ const suffix = path.slice(callSigPrefix.length);
5876
+ const returnValuePath = `functionCallReturnValue${suffix}`;
5877
+ varSchema[returnValuePath] = type;
5878
+ } else if (path === efc.callSignature) {
5879
+ // Include the function call type itself
5880
+ varSchema[path] = type;
5881
+ }
5882
+ }
5883
+ if (Object.keys(varSchema).length > 0) {
5884
+ perVariableSchemas[varName] = varSchema;
5885
+ }
5886
+ }
5887
+ // Only include if we have entries
5888
+ if (Object.keys(perVariableSchemas).length === 0) {
5889
+ perVariableSchemas = undefined;
5890
+ }
5891
+ }
5892
+ }
5893
+
5894
+ // Fallback: extract from root scope schema when perCallSignatureSchemas is not available
5895
+ // or doesn't have distinct entries for each variable.
5896
+ // This works when field accesses are in the root scope.
5897
+ if (
5898
+ !perVariableSchemas &&
5899
+ efc.receivingVariableNames &&
5900
+ efc.receivingVariableNames.length > 0
5901
+ ) {
5902
+ perVariableSchemas = {};
5903
+ for (const varName of efc.receivingVariableNames) {
5904
+ const varSchema: Record<string, string> = {};
5905
+ for (const [path, type] of Object.entries(rootSchema)) {
5906
+ // Check if path starts with this variable name
5907
+ if (
5908
+ path === varName ||
5909
+ path.startsWith(varName + '.') ||
5910
+ path.startsWith(varName + '[')
5911
+ ) {
5912
+ // Transform to functionCallReturnValue format
5913
+ // e.g., userFetcher.data.id -> functionCallReturnValue.data.id
5914
+ const suffix = path.slice(varName.length);
5915
+ const returnValuePath = `functionCallReturnValue${suffix}`;
5916
+ varSchema[returnValuePath] = type;
5917
+ }
5918
+ }
5919
+ if (Object.keys(varSchema).length > 0) {
5920
+ // Clean the variable name when using as key in output
5921
+ perVariableSchemas[cleanCyScope(varName)] = varSchema;
5922
+ }
5923
+ }
5924
+ // Only include if we have any entries
5925
+ if (Object.keys(perVariableSchemas).length === 0) {
5926
+ perVariableSchemas = undefined;
5927
+ }
5928
+ }
5929
+
5930
+ // Enrich the schema with inferred types by applying fillInSchemaGapsAndUnknowns.
5931
+ // This ensures the serialized schema has the same type inference as getReturnValue().
5932
+ // Without this, evidence like "entities[].analyses: array" becomes "unknown".
5933
+ const enrichedSchema = { ...efc.schema };
5934
+ const tempScopeNode = {
5935
+ name: efc.name,
5936
+ schema: enrichedSchema,
5937
+ equivalencies: efc.equivalencies ?? {},
5938
+ };
5939
+ fillInSchemaGapsAndUnknowns(tempScopeNode, true);
5940
+
5941
+ return {
5942
+ name: efc.name,
5943
+ callSignature: efc.callSignature,
5944
+ callScope: efc.callScope,
5945
+ schema: enrichedSchema,
5946
+ equivalencies: efc.equivalencies
5947
+ ? Object.entries(efc.equivalencies).reduce(
5948
+ (acc, [key, vars]) => {
5949
+ // Clean cyScope from the key as well as variable properties
5950
+ acc[cleanCyScope(key)] = toSerializableVariable(vars);
5951
+ return acc;
5952
+ },
5953
+ {} as Record<string, SerializableScopeVariable[]>,
5954
+ )
5955
+ : undefined,
5956
+ allCallSignatures: efc.allCallSignatures,
5957
+ receivingVariableNames: efc.receivingVariableNames?.map(cleanCyScope),
5958
+ callSignatureToVariable: efc.callSignatureToVariable
5959
+ ? Object.fromEntries(
5960
+ Object.entries(efc.callSignatureToVariable).map(([k, v]) => [
5961
+ k,
5962
+ cleanCyScope(v),
5963
+ ]),
5964
+ )
5965
+ : undefined,
5966
+ perVariableSchemas,
5967
+ };
5968
+ });
5969
+
5970
+ // POST-PROCESSING: Deduplicate schemas across parameterized calls to same base function
5971
+ // When useFetcher<ConfigData>() and useFetcher<SettingsData>() are called, they create
5972
+ // separate entries. Due to variable reassignment, BOTH entries may have ALL fields.
5973
+ // We deduplicate by assigning each field to ONLY ONE entry based on order of appearance.
5974
+ //
5975
+ // Strategy: Fields that appear first in order belong to the first entry,
5976
+ // fields that appear later belong to later entries (split evenly).
5977
+ const deduplicateParameterizedEntries = (
5978
+ entries: typeof externalFunctionCalls,
5979
+ ): typeof externalFunctionCalls => {
5980
+ // Group entries by base function name (without type parameters)
5981
+ const groups = new Map<string, typeof externalFunctionCalls>();
5982
+ for (const entry of entries) {
5983
+ // Extract base function name by stripping type parameters
5984
+ // e.g., "useFetcher<{ data: ConfigData | null }>" -> "useFetcher"
5985
+ const baseName = entry.name.replace(/<.*>$/, '');
5986
+ const group = groups.get(baseName) || [];
5987
+ group.push(entry);
5988
+ groups.set(baseName, group);
5989
+ }
5990
+
5991
+ // Process groups with multiple parameterized entries
5992
+ for (const [, group] of groups) {
5993
+ if (group.length <= 1) continue;
5994
+
5995
+ // Check if these are parameterized calls (have type parameters in name)
5996
+ const hasTypeParams = group.every((e) => e.name.includes('<'));
5997
+ if (!hasTypeParams) continue;
5998
+
5999
+ // Collect ALL unique field suffixes across all entries (in order of first appearance)
6000
+ // Field suffix is the path after functionCallReturnValue, e.g., ".data.data.theme"
6001
+ const allFieldSuffixes: string[] = [];
6002
+ for (const entry of group) {
6003
+ if (!entry.perVariableSchemas) continue;
6004
+ for (const varSchema of Object.values(entry.perVariableSchemas)) {
6005
+ for (const path of Object.keys(varSchema)) {
6006
+ // Skip the base "functionCallReturnValue" entry
6007
+ if (path === 'functionCallReturnValue') continue;
6008
+ // Extract field suffix
6009
+ const match = path.match(/functionCallReturnValue(.+)/);
6010
+ if (!match) continue;
6011
+ const fieldSuffix = match[1];
6012
+ if (!allFieldSuffixes.includes(fieldSuffix)) {
6013
+ allFieldSuffixes.push(fieldSuffix);
6014
+ }
6015
+ }
6016
+ }
6017
+ }
6018
+
6019
+ // Assign fields to entries: split evenly based on order
6020
+ // First N/2 fields go to first entry, remaining go to second entry
6021
+ const fieldToEntryMap = new Map<string, number>();
6022
+ const fieldsPerEntry = Math.ceil(
6023
+ allFieldSuffixes.length / group.length,
6024
+ );
6025
+ for (let i = 0; i < allFieldSuffixes.length; i++) {
6026
+ const fieldSuffix = allFieldSuffixes[i];
6027
+ const entryIdx = Math.min(
6028
+ Math.floor(i / fieldsPerEntry),
6029
+ group.length - 1,
6030
+ );
6031
+ fieldToEntryMap.set(fieldSuffix, entryIdx);
6032
+ }
6033
+
6034
+ // Filter each entry's perVariableSchemas to only include its assigned fields
6035
+ for (let i = 0; i < group.length; i++) {
6036
+ const entry = group[i];
6037
+ if (!entry.perVariableSchemas) continue;
6038
+
6039
+ const filteredPerVarSchemas: Record<
6040
+ string,
6041
+ Record<string, string>
6042
+ > = {};
6043
+ for (const [varName, varSchema] of Object.entries(
6044
+ entry.perVariableSchemas,
6045
+ )) {
6046
+ const filteredVarSchema: Record<string, string> = {};
6047
+ for (const [path, type] of Object.entries(varSchema)) {
6048
+ // Always keep the base functionCallReturnValue
6049
+ if (path === 'functionCallReturnValue') {
6050
+ filteredVarSchema[path] = type;
6051
+ continue;
6052
+ }
6053
+ // Extract field suffix
6054
+ const match = path.match(/functionCallReturnValue(.+)/);
6055
+ if (!match) {
6056
+ // Keep non-field paths
6057
+ filteredVarSchema[path] = type;
6058
+ continue;
6059
+ }
6060
+ const fieldSuffix = match[1];
6061
+ // Only include if this entry owns this field
6062
+ if (fieldToEntryMap.get(fieldSuffix) === i) {
6063
+ filteredVarSchema[path] = type;
6064
+ }
6065
+ }
6066
+ if (Object.keys(filteredVarSchema).length > 0) {
6067
+ filteredPerVarSchemas[varName] = filteredVarSchema;
6068
+ }
6069
+ }
6070
+ entry.perVariableSchemas =
6071
+ Object.keys(filteredPerVarSchemas).length > 0
6072
+ ? filteredPerVarSchemas
6073
+ : undefined;
6074
+ }
6075
+ }
6076
+
6077
+ return entries;
6078
+ };
6079
+
6080
+ // Apply deduplication
6081
+ const deduplicatedExternalFunctionCalls = deduplicateParameterizedEntries(
6082
+ externalFunctionCalls,
6083
+ );
6084
+
6085
+ // IMPORTANT: Get equivalent signature variables BEFORE calling getFunctionResult
6086
+ // because getFunctionResult calls validateSchema which may remove equivalencies
6087
+ // during the finalize step (e.g., cleanNonObjectFunctions removes method call
6088
+ // equivalencies like `segments -> splat.split('/').functionCallReturnValue`).
6089
+ // Fix 33: Move this call before any schema validation to preserve method call chains.
6090
+ const equivalentSignatureVariables = this.getEquivalentSignatureVariables();
3693
6091
 
3694
6092
  // Get root function result
3695
6093
  const rootFunction = getFunctionResult();
3696
6094
 
3697
- // Get results for each external function
6095
+ // Get results for each external function (use cleaned calls for consistency)
3698
6096
  const functionResults: Record<string, SerializableFunctionResult> = {};
3699
- for (const efc of this.externalFunctionCalls) {
6097
+ for (const efc of cleanedExternalCalls) {
3700
6098
  functionResults[efc.name] = getFunctionResult(efc.name);
3701
6099
  }
3702
6100
 
3703
- // Get equivalent signature variables
3704
- const equivalentSignatureVariables = this.getEquivalentSignatureVariables();
3705
-
3706
6101
  const environmentVariables = this.getEnvironmentVariables();
3707
6102
 
3708
6103
  // Get enriched conditional usages with source tracing
@@ -3712,13 +6107,43 @@ export class ScopeDataStructure {
3712
6107
  ? enrichedConditionalUsages
3713
6108
  : undefined;
3714
6109
 
6110
+ // Get conditional effects (setter calls inside conditionals)
6111
+ const conditionalEffects =
6112
+ this.rawConditionalEffects.length > 0
6113
+ ? this.rawConditionalEffects
6114
+ : undefined;
6115
+
6116
+ // Get compound conditionals (grouped conditions that must all be true)
6117
+ const compoundConditionals =
6118
+ this.rawCompoundConditionals.length > 0
6119
+ ? this.rawCompoundConditionals
6120
+ : undefined;
6121
+
6122
+ // Get child boundary gating conditions
6123
+ const enrichedGatingConditions =
6124
+ this.getEnrichedChildBoundaryGatingConditions();
6125
+ const childBoundaryGatingConditions =
6126
+ Object.keys(enrichedGatingConditions).length > 0
6127
+ ? enrichedGatingConditions
6128
+ : undefined;
6129
+
6130
+ // Get JSX rendering usages (arrays via .map(), strings via interpolation)
6131
+ const jsxRenderingUsages =
6132
+ this.rawJsxRenderingUsages.length > 0
6133
+ ? this.rawJsxRenderingUsages
6134
+ : undefined;
6135
+
3715
6136
  return {
3716
- externalFunctionCalls,
6137
+ externalFunctionCalls: deduplicatedExternalFunctionCalls,
3717
6138
  rootFunction,
3718
6139
  functionResults,
3719
6140
  equivalentSignatureVariables,
3720
6141
  environmentVariables,
3721
6142
  conditionalUsages,
6143
+ conditionalEffects,
6144
+ compoundConditionals,
6145
+ childBoundaryGatingConditions,
6146
+ jsxRenderingUsages,
3722
6147
  };
3723
6148
  }
3724
6149