@codeyam/codeyam-cli 0.1.0-staging.dd216e0 → 0.1.0-staging.e2d4438

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 (970) 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 +16 -13
  5. package/analyzer-template/packages/ai/index.ts +21 -5
  6. package/analyzer-template/packages/ai/package.json +3 -3
  7. package/analyzer-template/packages/ai/src/lib/__mocks__/completionCall.ts +122 -0
  8. package/analyzer-template/packages/ai/src/lib/analyzeScope.ts +226 -24
  9. package/analyzer-template/packages/ai/src/lib/astScopes/arrayDerivationDetector.ts +199 -0
  10. package/analyzer-template/packages/ai/src/lib/astScopes/astScopeAnalyzer.ts +205 -10
  11. package/analyzer-template/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.ts +644 -0
  12. package/analyzer-template/packages/ai/src/lib/astScopes/methodSemantics.ts +181 -23
  13. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.ts +10 -17
  14. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.ts +18 -0
  15. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.ts +38 -1
  16. package/analyzer-template/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.ts +181 -1
  17. package/analyzer-template/packages/ai/src/lib/astScopes/processExpression.ts +1507 -117
  18. package/analyzer-template/packages/ai/src/lib/astScopes/sharedPatterns.ts +28 -0
  19. package/analyzer-template/packages/ai/src/lib/astScopes/types.ts +324 -5
  20. package/analyzer-template/packages/ai/src/lib/checkAllAttributes.ts +29 -10
  21. package/analyzer-template/packages/ai/src/lib/completionCall.ts +216 -36
  22. package/analyzer-template/packages/ai/src/lib/dataStructure/ScopeDataStructure.ts +2227 -350
  23. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.ts +7 -2
  24. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.ts +296 -35
  25. package/analyzer-template/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.ts +120 -76
  26. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.ts +16 -3
  27. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.ts +6 -4
  28. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.ts +54 -3
  29. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.ts +161 -19
  30. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.ts +70 -0
  31. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.ts +163 -14
  32. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.ts +98 -0
  33. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.ts +179 -0
  34. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.ts +40 -30
  35. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.ts +396 -88
  36. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.ts +129 -0
  37. package/analyzer-template/packages/ai/src/lib/dataStructureChunking.ts +183 -0
  38. package/analyzer-template/packages/ai/src/lib/deepEqual.ts +30 -0
  39. package/analyzer-template/packages/ai/src/lib/e2eDataTracking.ts +334 -0
  40. package/analyzer-template/packages/ai/src/lib/extractCriticalDataKeys.ts +120 -0
  41. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarioData.ts +74 -7
  42. package/analyzer-template/packages/ai/src/lib/generateChangesEntityScenarios.ts +89 -112
  43. package/analyzer-template/packages/ai/src/lib/generateEntityDataStructure.ts +59 -3
  44. package/analyzer-template/packages/ai/src/lib/generateEntityScenarioData.ts +1421 -92
  45. package/analyzer-template/packages/ai/src/lib/generateEntityScenarios.ts +216 -109
  46. package/analyzer-template/packages/ai/src/lib/generateExecutionFlows.ts +710 -0
  47. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.ts +528 -0
  48. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromConditionals.ts +2484 -0
  49. package/analyzer-template/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.ts +239 -0
  50. package/analyzer-template/packages/ai/src/lib/getConditionalUsagesFromCode.ts +143 -31
  51. package/analyzer-template/packages/ai/src/lib/guessScenarioDataFromDescription.ts +8 -2
  52. package/analyzer-template/packages/ai/src/lib/isolateScopes.ts +328 -7
  53. package/analyzer-template/packages/ai/src/lib/mergeJsonTypeDefinitions.ts +5 -0
  54. package/analyzer-template/packages/ai/src/lib/mergeStatements.ts +111 -87
  55. package/analyzer-template/packages/ai/src/lib/promptGenerators/collapseNullableObjects.ts +118 -0
  56. package/analyzer-template/packages/ai/src/lib/promptGenerators/gatherAttributesMap.ts +17 -7
  57. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.ts +1 -1
  58. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.ts +32 -102
  59. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateChunkPrompt.ts +82 -0
  60. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateCriticalKeysPrompt.ts +103 -0
  61. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.ts +110 -6
  62. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.ts +14 -53
  63. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.ts +58 -0
  64. package/analyzer-template/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.ts +28 -2
  65. package/analyzer-template/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.ts +391 -0
  66. package/analyzer-template/packages/ai/src/lib/resolvePathToControllable.ts +824 -0
  67. package/analyzer-template/packages/ai/src/lib/splitOutsideParentheses.ts +5 -1
  68. package/analyzer-template/packages/ai/src/lib/validateExecutionFlowPaths.ts +531 -0
  69. package/analyzer-template/packages/ai/src/lib/worker/SerializableDataStructure.ts +127 -3
  70. package/analyzer-template/packages/ai/src/lib/worker/analyzeScopeWorker.ts +114 -2
  71. package/analyzer-template/packages/analyze/index.ts +2 -0
  72. package/analyzer-template/packages/analyze/src/lib/FileAnalyzer.ts +79 -59
  73. package/analyzer-template/packages/analyze/src/lib/ProjectAnalyzer.ts +113 -26
  74. package/analyzer-template/packages/analyze/src/lib/analysisContext.ts +44 -4
  75. package/analyzer-template/packages/analyze/src/lib/asts/nodes/index.ts +1 -0
  76. package/analyzer-template/packages/analyze/src/lib/asts/nodes/isAsyncFunction.ts +67 -0
  77. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.ts +19 -0
  78. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.ts +19 -0
  79. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getAllExports.ts +11 -0
  80. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.ts +8 -0
  81. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.ts +49 -1
  82. package/analyzer-template/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.ts +2 -1
  83. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.ts +532 -275
  84. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities.ts +34 -1
  85. package/analyzer-template/packages/analyze/src/lib/files/analyze/dependencyResolver.ts +6 -0
  86. package/analyzer-template/packages/analyze/src/lib/files/analyze/findOrCreateEntity.ts +3 -0
  87. package/analyzer-template/packages/analyze/src/lib/files/analyze/gatherEntityMap.ts +4 -2
  88. package/analyzer-template/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.ts +33 -10
  89. package/analyzer-template/packages/analyze/src/lib/files/analyzeChange.ts +31 -15
  90. package/analyzer-template/packages/analyze/src/lib/files/analyzeEntity.ts +11 -7
  91. package/analyzer-template/packages/analyze/src/lib/files/analyzeInitial.ts +11 -12
  92. package/analyzer-template/packages/analyze/src/lib/files/analyzeRemixRoute.ts +4 -5
  93. package/analyzer-template/packages/analyze/src/lib/files/enums/steps.ts +1 -1
  94. package/analyzer-template/packages/analyze/src/lib/files/getImportedExports.ts +14 -12
  95. package/analyzer-template/packages/analyze/src/lib/files/scenarios/TransformationTracer.ts +1315 -0
  96. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.ts +201 -46
  97. package/analyzer-template/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.ts +102 -0
  98. package/analyzer-template/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.ts +670 -74
  99. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.ts +1 -1
  100. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.ts +28 -62
  101. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateDataStructure.ts +380 -45
  102. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.ts +264 -0
  103. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarioData.ts +78 -83
  104. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateScenarios.ts +4 -8
  105. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.ts +970 -140
  106. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.ts +56 -11
  107. package/analyzer-template/packages/analyze/src/lib/files/scenarios/propagateArrayItemSchemas.ts +474 -0
  108. package/analyzer-template/packages/analyze/src/lib/files/setImportedExports.ts +2 -1
  109. package/analyzer-template/packages/analyze/src/lib/index.ts +1 -0
  110. package/analyzer-template/packages/analyze/src/lib/utils/getFileByPath.ts +19 -0
  111. package/analyzer-template/packages/aws/codebuild/index.ts +1 -0
  112. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts +11 -1
  113. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.d.ts.map +1 -1
  114. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js +29 -18
  115. package/analyzer-template/packages/aws/dist/src/lib/codebuild/waitForBuild.js.map +1 -1
  116. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts +2 -2
  117. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.d.ts.map +1 -1
  118. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js +2 -2
  119. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  120. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts +8 -18
  121. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.d.ts.map +1 -1
  122. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js +17 -61
  123. package/analyzer-template/packages/aws/dist/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  124. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.d.ts +15 -0
  125. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.d.ts.map +1 -0
  126. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.js +31 -0
  127. package/analyzer-template/packages/aws/dist/src/lib/s3/checkS3ObjectExists.js.map +1 -0
  128. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.d.ts.map +1 -1
  129. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js +8 -1
  130. package/analyzer-template/packages/aws/dist/src/lib/s3/uploadFileToS3.js.map +1 -1
  131. package/analyzer-template/packages/aws/package.json +3 -3
  132. package/analyzer-template/packages/aws/s3/index.ts +1 -0
  133. package/analyzer-template/packages/aws/src/lib/codebuild/waitForBuild.ts +43 -19
  134. package/analyzer-template/packages/aws/src/lib/ecs/ecsDefineContainer.ts +3 -3
  135. package/analyzer-template/packages/aws/src/lib/ecs/ecsTaskFactory.ts +17 -69
  136. package/analyzer-template/packages/aws/src/lib/s3/checkS3ObjectExists.ts +47 -0
  137. package/analyzer-template/packages/aws/src/lib/s3/uploadFileToS3.ts +8 -1
  138. package/analyzer-template/packages/database/package.json +1 -1
  139. package/analyzer-template/packages/database/src/lib/analysisBranchToDb.ts +1 -1
  140. package/analyzer-template/packages/database/src/lib/analysisToDb.ts +1 -1
  141. package/analyzer-template/packages/database/src/lib/branchToDb.ts +1 -1
  142. package/analyzer-template/packages/database/src/lib/commitBranchToDb.ts +1 -1
  143. package/analyzer-template/packages/database/src/lib/commitToDb.ts +1 -1
  144. package/analyzer-template/packages/database/src/lib/fileToDb.ts +1 -1
  145. package/analyzer-template/packages/database/src/lib/kysely/db.ts +18 -5
  146. package/analyzer-template/packages/database/src/lib/kysely/tableRelations.ts +2 -2
  147. package/analyzer-template/packages/database/src/lib/kysely/tables/commitsTable.ts +6 -0
  148. package/analyzer-template/packages/database/src/lib/kysely/tables/debugReportsTable.ts +36 -9
  149. package/analyzer-template/packages/database/src/lib/kysely/tables/labsRequestsTable.ts +52 -0
  150. package/analyzer-template/packages/database/src/lib/loadAnalyses.ts +58 -1
  151. package/analyzer-template/packages/database/src/lib/loadAnalysis.ts +13 -0
  152. package/analyzer-template/packages/database/src/lib/loadBranch.ts +16 -1
  153. package/analyzer-template/packages/database/src/lib/loadCommit.ts +11 -0
  154. package/analyzer-template/packages/database/src/lib/loadCommits.ts +28 -0
  155. package/analyzer-template/packages/database/src/lib/loadEntities.ts +26 -3
  156. package/analyzer-template/packages/database/src/lib/loadEntityBranches.ts +12 -0
  157. package/analyzer-template/packages/database/src/lib/loadReadyToBeCapturedAnalyses.ts +7 -3
  158. package/analyzer-template/packages/database/src/lib/projectToDb.ts +1 -1
  159. package/analyzer-template/packages/database/src/lib/saveFiles.ts +1 -1
  160. package/analyzer-template/packages/database/src/lib/scenarioToDb.ts +1 -1
  161. package/analyzer-template/packages/database/src/lib/updateCommitMetadata.ts +7 -14
  162. package/analyzer-template/packages/database/src/lib/userScenarioToDb.ts +1 -1
  163. package/analyzer-template/packages/generate/index.ts +3 -0
  164. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.ts +17 -1
  165. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.ts +193 -0
  166. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.ts +73 -0
  167. package/analyzer-template/packages/generate/src/lib/deepMerge.ts +26 -1
  168. package/analyzer-template/packages/generate/src/lib/scenarioComponentForServer.ts +114 -0
  169. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js +1 -1
  170. package/analyzer-template/packages/github/dist/database/src/lib/analysisBranchToDb.js.map +1 -1
  171. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js +1 -1
  172. package/analyzer-template/packages/github/dist/database/src/lib/analysisToDb.js.map +1 -1
  173. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js +1 -1
  174. package/analyzer-template/packages/github/dist/database/src/lib/branchToDb.js.map +1 -1
  175. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js +1 -1
  176. package/analyzer-template/packages/github/dist/database/src/lib/commitBranchToDb.js.map +1 -1
  177. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js +1 -1
  178. package/analyzer-template/packages/github/dist/database/src/lib/commitToDb.js.map +1 -1
  179. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js +1 -1
  180. package/analyzer-template/packages/github/dist/database/src/lib/fileToDb.js.map +1 -1
  181. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts +4 -2
  182. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts.map +1 -1
  183. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js +13 -3
  184. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js.map +1 -1
  185. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tableRelations.d.ts +2 -2
  186. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts +1 -11
  187. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/analysesTable.d.ts.map +1 -1
  188. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts +1 -0
  189. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.d.ts.map +1 -1
  190. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js +3 -0
  191. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  192. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts +30 -7
  193. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.d.ts.map +1 -1
  194. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.js +9 -3
  195. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  196. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts +1 -0
  197. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/entitiesTable.d.ts.map +1 -1
  198. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts +23 -0
  199. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.d.ts.map +1 -0
  200. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  201. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  202. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts +2 -6
  203. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts.map +1 -1
  204. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts +2 -0
  205. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.d.ts.map +1 -1
  206. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js +45 -2
  207. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalyses.js.map +1 -1
  208. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.d.ts.map +1 -1
  209. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js +8 -0
  210. package/analyzer-template/packages/github/dist/database/src/lib/loadAnalysis.js.map +1 -1
  211. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js +11 -1
  212. package/analyzer-template/packages/github/dist/database/src/lib/loadBranch.js.map +1 -1
  213. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.d.ts.map +1 -1
  214. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js +7 -0
  215. package/analyzer-template/packages/github/dist/database/src/lib/loadCommit.js.map +1 -1
  216. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts +3 -1
  217. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts.map +1 -1
  218. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js +22 -1
  219. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js.map +1 -1
  220. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts +3 -1
  221. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts.map +1 -1
  222. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js +23 -4
  223. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js.map +1 -1
  224. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.d.ts.map +1 -1
  225. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js +9 -0
  226. package/analyzer-template/packages/github/dist/database/src/lib/loadEntityBranches.js.map +1 -1
  227. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.d.ts.map +1 -1
  228. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js +7 -4
  229. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  230. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js +1 -1
  231. package/analyzer-template/packages/github/dist/database/src/lib/projectToDb.js.map +1 -1
  232. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js +1 -1
  233. package/analyzer-template/packages/github/dist/database/src/lib/saveFiles.js.map +1 -1
  234. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js +1 -1
  235. package/analyzer-template/packages/github/dist/database/src/lib/scenarioToDb.js.map +1 -1
  236. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts +2 -2
  237. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts.map +1 -1
  238. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js +5 -4
  239. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js.map +1 -1
  240. package/analyzer-template/packages/github/dist/generate/index.d.ts +3 -0
  241. package/analyzer-template/packages/github/dist/generate/index.d.ts.map +1 -1
  242. package/analyzer-template/packages/github/dist/generate/index.js +3 -0
  243. package/analyzer-template/packages/github/dist/generate/index.js.map +1 -1
  244. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.d.ts.map +1 -1
  245. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  246. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  247. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts +9 -0
  248. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts.map +1 -0
  249. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +189 -0
  250. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  251. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts +20 -0
  252. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.d.ts.map +1 -0
  253. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  254. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  255. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.d.ts.map +1 -1
  256. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js +27 -1
  257. package/analyzer-template/packages/github/dist/generate/src/lib/deepMerge.js.map +1 -1
  258. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts +8 -0
  259. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.d.ts.map +1 -0
  260. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js +89 -0
  261. package/analyzer-template/packages/github/dist/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  262. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.d.ts.map +1 -1
  263. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js +10 -0
  264. package/analyzer-template/packages/github/dist/github/src/lib/loadOrCreateCommit.js.map +1 -1
  265. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.d.ts.map +1 -1
  266. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js +3 -0
  267. package/analyzer-template/packages/github/dist/github/src/lib/syncPrimaryBranch.js.map +1 -1
  268. package/analyzer-template/packages/github/dist/types/index.d.ts +2 -2
  269. package/analyzer-template/packages/github/dist/types/index.d.ts.map +1 -1
  270. package/analyzer-template/packages/github/dist/types/index.js.map +1 -1
  271. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts +87 -13
  272. package/analyzer-template/packages/github/dist/types/src/types/Analysis.d.ts.map +1 -1
  273. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts +2 -0
  274. package/analyzer-template/packages/github/dist/types/src/types/Commit.d.ts.map +1 -1
  275. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts +2 -0
  276. package/analyzer-template/packages/github/dist/types/src/types/Entity.d.ts.map +1 -1
  277. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts +7 -0
  278. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  279. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts +11 -6
  280. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts.map +1 -1
  281. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts +199 -3
  282. package/analyzer-template/packages/github/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  283. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  284. package/analyzer-template/packages/github/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  285. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts +2 -0
  286. package/analyzer-template/packages/github/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  287. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts +9 -1
  288. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  289. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js +29 -3
  290. package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js.map +1 -1
  291. package/analyzer-template/packages/github/package.json +1 -1
  292. package/analyzer-template/packages/github/src/lib/loadOrCreateCommit.ts +14 -0
  293. package/analyzer-template/packages/github/src/lib/syncPrimaryBranch.ts +2 -0
  294. package/analyzer-template/packages/process/index.ts +2 -0
  295. package/analyzer-template/packages/process/package.json +12 -0
  296. package/analyzer-template/packages/process/tsconfig.json +8 -0
  297. package/analyzer-template/packages/types/index.ts +5 -0
  298. package/analyzer-template/packages/types/src/types/Analysis.ts +104 -13
  299. package/analyzer-template/packages/types/src/types/Commit.ts +2 -0
  300. package/analyzer-template/packages/types/src/types/Entity.ts +2 -0
  301. package/analyzer-template/packages/types/src/types/ProjectMetadata.ts +7 -0
  302. package/analyzer-template/packages/types/src/types/Scenario.ts +11 -10
  303. package/analyzer-template/packages/types/src/types/ScenariosDataStructure.ts +228 -3
  304. package/analyzer-template/packages/types/src/types/ScopeAnalysis.ts +6 -1
  305. package/analyzer-template/packages/types/src/types/StatementInfo.ts +2 -0
  306. package/analyzer-template/packages/utils/dist/types/index.d.ts +2 -2
  307. package/analyzer-template/packages/utils/dist/types/index.d.ts.map +1 -1
  308. package/analyzer-template/packages/utils/dist/types/index.js.map +1 -1
  309. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts +87 -13
  310. package/analyzer-template/packages/utils/dist/types/src/types/Analysis.d.ts.map +1 -1
  311. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts +2 -0
  312. package/analyzer-template/packages/utils/dist/types/src/types/Commit.d.ts.map +1 -1
  313. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts +2 -0
  314. package/analyzer-template/packages/utils/dist/types/src/types/Entity.d.ts.map +1 -1
  315. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts +7 -0
  316. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  317. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts +11 -6
  318. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts.map +1 -1
  319. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts +199 -3
  320. package/analyzer-template/packages/utils/dist/types/src/types/ScenariosDataStructure.d.ts.map +1 -1
  321. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts +6 -1
  322. package/analyzer-template/packages/utils/dist/types/src/types/ScopeAnalysis.d.ts.map +1 -1
  323. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts +2 -0
  324. package/analyzer-template/packages/utils/dist/types/src/types/StatementInfo.d.ts.map +1 -1
  325. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.d.ts.map +1 -1
  326. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js +93 -2
  327. package/analyzer-template/packages/utils/dist/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  328. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts +9 -1
  329. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.d.ts.map +1 -1
  330. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js +29 -3
  331. package/analyzer-template/packages/utils/dist/utils/src/lib/safeFileName.js.map +1 -1
  332. package/analyzer-template/packages/utils/src/lib/fs/rsyncCopy.ts +108 -2
  333. package/analyzer-template/packages/utils/src/lib/safeFileName.ts +48 -3
  334. package/analyzer-template/playwright/capture.ts +57 -26
  335. package/analyzer-template/playwright/captureStatic.ts +1 -1
  336. package/analyzer-template/playwright/getCodeYamInfo.ts +12 -7
  337. package/analyzer-template/playwright/waitForServer.ts +21 -6
  338. package/analyzer-template/project/analyzeBaselineCommit.ts +9 -0
  339. package/analyzer-template/project/analyzeBranchCommit.ts +4 -0
  340. package/analyzer-template/project/analyzeFileEntities.ts +4 -0
  341. package/analyzer-template/project/analyzeRegularCommit.ts +9 -0
  342. package/analyzer-template/project/captureLibraryFunctionDirect.ts +29 -26
  343. package/analyzer-template/project/constructMockCode.ts +1201 -169
  344. package/analyzer-template/project/controller/startController.ts +16 -1
  345. package/analyzer-template/project/createEntitiesAndSortFiles.ts +83 -0
  346. package/analyzer-template/project/executeLibraryFunctionDirect.ts +7 -3
  347. package/analyzer-template/project/loadReadyToBeCaptured.ts +65 -41
  348. package/analyzer-template/project/mocks/analyzeFileMock.ts +8 -7
  349. package/analyzer-template/project/orchestrateCapture/AwsCaptureTaskRunner.ts +12 -4
  350. package/analyzer-template/project/orchestrateCapture/KyselyAnalysisLoader.ts +3 -6
  351. package/analyzer-template/project/orchestrateCapture/SequentialCaptureTaskRunner.ts +18 -7
  352. package/analyzer-template/project/orchestrateCapture/taskRunner.ts +4 -2
  353. package/analyzer-template/project/orchestrateCapture.ts +81 -9
  354. package/analyzer-template/project/reconcileMockDataKeys.ts +245 -2
  355. package/analyzer-template/project/runAnalysis.ts +11 -0
  356. package/analyzer-template/project/serverOnlyModules.ts +127 -2
  357. package/analyzer-template/project/start.ts +51 -15
  358. package/analyzer-template/project/startScenarioCapture.ts +6 -0
  359. package/analyzer-template/project/writeMockDataTsx.ts +403 -61
  360. package/analyzer-template/project/writeScenarioClientWrapper.ts +21 -0
  361. package/analyzer-template/project/writeScenarioComponents.ts +409 -98
  362. package/analyzer-template/project/writeScenarioFiles.ts +26 -0
  363. package/analyzer-template/project/writeSimpleRoot.ts +31 -23
  364. package/analyzer-template/scripts/comboWorkerLoop.cjs +99 -50
  365. package/analyzer-template/scripts/defaultCmd.sh +9 -0
  366. package/analyzer-template/tsconfig.json +2 -1
  367. package/background/src/lib/local/createLocalAnalyzer.js +2 -30
  368. package/background/src/lib/local/createLocalAnalyzer.js.map +1 -1
  369. package/background/src/lib/local/execAsync.js +1 -1
  370. package/background/src/lib/local/execAsync.js.map +1 -1
  371. package/background/src/lib/virtualized/common/execAsync.js +1 -1
  372. package/background/src/lib/virtualized/common/execAsync.js.map +1 -1
  373. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js +7 -1
  374. package/background/src/lib/virtualized/project/analyzeBaselineCommit.js.map +1 -1
  375. package/background/src/lib/virtualized/project/analyzeBranchCommit.js +2 -1
  376. package/background/src/lib/virtualized/project/analyzeBranchCommit.js.map +1 -1
  377. package/background/src/lib/virtualized/project/analyzeFileEntities.js +2 -1
  378. package/background/src/lib/virtualized/project/analyzeFileEntities.js.map +1 -1
  379. package/background/src/lib/virtualized/project/analyzeRegularCommit.js +7 -1
  380. package/background/src/lib/virtualized/project/analyzeRegularCommit.js.map +1 -1
  381. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js +3 -3
  382. package/background/src/lib/virtualized/project/captureLibraryFunctionDirect.js.map +1 -1
  383. package/background/src/lib/virtualized/project/constructMockCode.js +1062 -127
  384. package/background/src/lib/virtualized/project/constructMockCode.js.map +1 -1
  385. package/background/src/lib/virtualized/project/controller/startController.js +11 -1
  386. package/background/src/lib/virtualized/project/controller/startController.js.map +1 -1
  387. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js +73 -1
  388. package/background/src/lib/virtualized/project/createEntitiesAndSortFiles.js.map +1 -1
  389. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js +6 -3
  390. package/background/src/lib/virtualized/project/executeLibraryFunctionDirect.js.map +1 -1
  391. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js +19 -8
  392. package/background/src/lib/virtualized/project/loadReadyToBeCaptured.js.map +1 -1
  393. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js +7 -7
  394. package/background/src/lib/virtualized/project/mocks/analyzeFileMock.js.map +1 -1
  395. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js +2 -2
  396. package/background/src/lib/virtualized/project/orchestrateCapture/AwsCaptureTaskRunner.js.map +1 -1
  397. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js +3 -2
  398. package/background/src/lib/virtualized/project/orchestrateCapture/KyselyAnalysisLoader.js.map +1 -1
  399. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js +7 -5
  400. package/background/src/lib/virtualized/project/orchestrateCapture/SequentialCaptureTaskRunner.js.map +1 -1
  401. package/background/src/lib/virtualized/project/orchestrateCapture.js +65 -10
  402. package/background/src/lib/virtualized/project/orchestrateCapture.js.map +1 -1
  403. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js +204 -2
  404. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js.map +1 -1
  405. package/background/src/lib/virtualized/project/runAnalysis.js +9 -0
  406. package/background/src/lib/virtualized/project/runAnalysis.js.map +1 -1
  407. package/background/src/lib/virtualized/project/serverOnlyModules.js +106 -3
  408. package/background/src/lib/virtualized/project/serverOnlyModules.js.map +1 -1
  409. package/background/src/lib/virtualized/project/start.js +47 -15
  410. package/background/src/lib/virtualized/project/start.js.map +1 -1
  411. package/background/src/lib/virtualized/project/startScenarioCapture.js +7 -0
  412. package/background/src/lib/virtualized/project/startScenarioCapture.js.map +1 -1
  413. package/background/src/lib/virtualized/project/writeMockDataTsx.js +350 -50
  414. package/background/src/lib/virtualized/project/writeMockDataTsx.js.map +1 -1
  415. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js +15 -0
  416. package/background/src/lib/virtualized/project/writeScenarioClientWrapper.js.map +1 -0
  417. package/background/src/lib/virtualized/project/writeScenarioComponents.js +313 -83
  418. package/background/src/lib/virtualized/project/writeScenarioComponents.js.map +1 -1
  419. package/background/src/lib/virtualized/project/writeScenarioFiles.js +19 -0
  420. package/background/src/lib/virtualized/project/writeScenarioFiles.js.map +1 -1
  421. package/background/src/lib/virtualized/project/writeSimpleRoot.js +31 -21
  422. package/background/src/lib/virtualized/project/writeSimpleRoot.js.map +1 -1
  423. package/codeyam-cli/scripts/apply-setup.js +180 -0
  424. package/codeyam-cli/scripts/apply-setup.js.map +1 -1
  425. package/codeyam-cli/src/cli.js +9 -1
  426. package/codeyam-cli/src/cli.js.map +1 -1
  427. package/codeyam-cli/src/codeyam-cli.js +18 -2
  428. package/codeyam-cli/src/codeyam-cli.js.map +1 -1
  429. package/codeyam-cli/src/commands/analyze.js +5 -3
  430. package/codeyam-cli/src/commands/analyze.js.map +1 -1
  431. package/codeyam-cli/src/commands/baseline.js +176 -0
  432. package/codeyam-cli/src/commands/baseline.js.map +1 -0
  433. package/codeyam-cli/src/commands/debug.js +37 -23
  434. package/codeyam-cli/src/commands/debug.js.map +1 -1
  435. package/codeyam-cli/src/commands/default.js +30 -34
  436. package/codeyam-cli/src/commands/default.js.map +1 -1
  437. package/codeyam-cli/src/commands/detect-universal-mocks.js +2 -0
  438. package/codeyam-cli/src/commands/detect-universal-mocks.js.map +1 -1
  439. package/codeyam-cli/src/commands/init.js +49 -257
  440. package/codeyam-cli/src/commands/init.js.map +1 -1
  441. package/codeyam-cli/src/commands/memory.js +307 -0
  442. package/codeyam-cli/src/commands/memory.js.map +1 -0
  443. package/codeyam-cli/src/commands/recapture.js +31 -18
  444. package/codeyam-cli/src/commands/recapture.js.map +1 -1
  445. package/codeyam-cli/src/commands/report.js +72 -24
  446. package/codeyam-cli/src/commands/report.js.map +1 -1
  447. package/codeyam-cli/src/commands/setup-sandbox.js +2 -0
  448. package/codeyam-cli/src/commands/setup-sandbox.js.map +1 -1
  449. package/codeyam-cli/src/commands/setup-simulations.js +284 -0
  450. package/codeyam-cli/src/commands/setup-simulations.js.map +1 -0
  451. package/codeyam-cli/src/commands/start.js +8 -12
  452. package/codeyam-cli/src/commands/start.js.map +1 -1
  453. package/codeyam-cli/src/commands/status.js +23 -1
  454. package/codeyam-cli/src/commands/status.js.map +1 -1
  455. package/codeyam-cli/src/commands/test-startup.js +3 -1
  456. package/codeyam-cli/src/commands/test-startup.js.map +1 -1
  457. package/codeyam-cli/src/commands/verify.js +14 -2
  458. package/codeyam-cli/src/commands/verify.js.map +1 -1
  459. package/codeyam-cli/src/commands/wipe.js +108 -0
  460. package/codeyam-cli/src/commands/wipe.js.map +1 -0
  461. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js +179 -0
  462. package/codeyam-cli/src/utils/__tests__/npmVersionCheck.test.js.map +1 -0
  463. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js +81 -0
  464. package/codeyam-cli/src/utils/__tests__/serverVersionStaleness.test.js.map +1 -0
  465. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js +128 -82
  466. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js.map +1 -1
  467. package/codeyam-cli/src/utils/analysisRunner.js +29 -15
  468. package/codeyam-cli/src/utils/analysisRunner.js.map +1 -1
  469. package/codeyam-cli/src/utils/analyzer.js +7 -0
  470. package/codeyam-cli/src/utils/analyzer.js.map +1 -1
  471. package/codeyam-cli/src/utils/backgroundServer.js +102 -21
  472. package/codeyam-cli/src/utils/backgroundServer.js.map +1 -1
  473. package/codeyam-cli/src/utils/database.js +91 -5
  474. package/codeyam-cli/src/utils/database.js.map +1 -1
  475. package/codeyam-cli/src/utils/generateReport.js +253 -106
  476. package/codeyam-cli/src/utils/generateReport.js.map +1 -1
  477. package/codeyam-cli/src/utils/git.js +79 -0
  478. package/codeyam-cli/src/utils/git.js.map +1 -0
  479. package/codeyam-cli/src/utils/install-skills.js +76 -37
  480. package/codeyam-cli/src/utils/install-skills.js.map +1 -1
  481. package/codeyam-cli/src/utils/labsAutoCheck.js +19 -0
  482. package/codeyam-cli/src/utils/labsAutoCheck.js.map +1 -0
  483. package/codeyam-cli/src/utils/npmVersionCheck.js +76 -0
  484. package/codeyam-cli/src/utils/npmVersionCheck.js.map +1 -0
  485. package/codeyam-cli/src/utils/progress.js +7 -0
  486. package/codeyam-cli/src/utils/progress.js.map +1 -1
  487. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js +38 -0
  488. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js.map +1 -1
  489. package/codeyam-cli/src/utils/queue/job.js +138 -18
  490. package/codeyam-cli/src/utils/queue/job.js.map +1 -1
  491. package/codeyam-cli/src/utils/queue/manager.js +25 -7
  492. package/codeyam-cli/src/utils/queue/manager.js.map +1 -1
  493. package/codeyam-cli/src/utils/queue/persistence.js.map +1 -1
  494. package/codeyam-cli/src/utils/requireSimulations.js +10 -0
  495. package/codeyam-cli/src/utils/requireSimulations.js.map +1 -0
  496. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js +82 -0
  497. package/codeyam-cli/src/utils/ruleReflection/__tests__/confusionDetector.test.js.map +1 -0
  498. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js +230 -0
  499. package/codeyam-cli/src/utils/ruleReflection/__tests__/contextBuilder.test.js.map +1 -0
  500. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js +67 -0
  501. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/assertRules.js.map +1 -0
  502. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js +105 -0
  503. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/captureFixture.js.map +1 -0
  504. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js +34 -0
  505. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.js.map +1 -0
  506. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js +162 -0
  507. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/runClaude.js.map +1 -0
  508. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js +74 -0
  509. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js.map +1 -0
  510. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js +376 -0
  511. package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js.map +1 -0
  512. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js +116 -0
  513. package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js.map +1 -0
  514. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js +127 -0
  515. package/codeyam-cli/src/utils/ruleReflection/__tests__/transcriptParser.test.js.map +1 -0
  516. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js +50 -0
  517. package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js.map +1 -0
  518. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js +116 -0
  519. package/codeyam-cli/src/utils/ruleReflection/contextBuilder.js.map +1 -0
  520. package/codeyam-cli/src/utils/ruleReflection/index.js +5 -0
  521. package/codeyam-cli/src/utils/ruleReflection/index.js.map +1 -0
  522. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js +44 -0
  523. package/codeyam-cli/src/utils/ruleReflection/promptBuilder.js.map +1 -0
  524. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js +85 -0
  525. package/codeyam-cli/src/utils/ruleReflection/transcriptParser.js.map +1 -0
  526. package/codeyam-cli/src/utils/ruleReflection/types.js +5 -0
  527. package/codeyam-cli/src/utils/ruleReflection/types.js.map +1 -0
  528. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js +293 -0
  529. package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js.map +1 -0
  530. package/codeyam-cli/src/utils/rules/index.js +6 -0
  531. package/codeyam-cli/src/utils/rules/index.js.map +1 -0
  532. package/codeyam-cli/src/utils/rules/parser.js +83 -0
  533. package/codeyam-cli/src/utils/rules/parser.js.map +1 -0
  534. package/codeyam-cli/src/utils/rules/pathMatcher.js +18 -0
  535. package/codeyam-cli/src/utils/rules/pathMatcher.js.map +1 -0
  536. package/codeyam-cli/src/utils/rules/ruleState.js +150 -0
  537. package/codeyam-cli/src/utils/rules/ruleState.js.map +1 -0
  538. package/codeyam-cli/src/utils/rules/staleness.js +137 -0
  539. package/codeyam-cli/src/utils/rules/staleness.js.map +1 -0
  540. package/codeyam-cli/src/utils/serverState.js +37 -10
  541. package/codeyam-cli/src/utils/serverState.js.map +1 -1
  542. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js +21 -42
  543. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js.map +1 -1
  544. package/codeyam-cli/src/utils/versionInfo.js +46 -15
  545. package/codeyam-cli/src/utils/versionInfo.js.map +1 -1
  546. package/codeyam-cli/src/utils/wipe.js +128 -0
  547. package/codeyam-cli/src/utils/wipe.js.map +1 -0
  548. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js +66 -0
  549. package/codeyam-cli/src/webserver/__tests__/dependency-smoke.test.js.map +1 -0
  550. package/codeyam-cli/src/webserver/app/lib/database.js +88 -23
  551. package/codeyam-cli/src/webserver/app/lib/database.js.map +1 -1
  552. package/codeyam-cli/src/webserver/app/lib/dbNotifier.js.map +1 -1
  553. package/codeyam-cli/src/webserver/backgroundServer.js +52 -5
  554. package/codeyam-cli/src/webserver/backgroundServer.js.map +1 -1
  555. package/codeyam-cli/src/webserver/bootstrap.js +51 -0
  556. package/codeyam-cli/src/webserver/bootstrap.js.map +1 -1
  557. package/codeyam-cli/src/webserver/build/client/assets/CopyButton-jNYXRRNI.js +1 -0
  558. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-bwuHPyTa.js +11 -0
  559. package/codeyam-cli/src/webserver/build/client/assets/{EntityTypeBadge-CMjhlvyu.js → EntityTypeBadge-CvzqMxcu.js} +1 -1
  560. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-BH0XDim7.js +41 -0
  561. package/codeyam-cli/src/webserver/build/client/assets/InlineSpinner-EhOseatT.js +34 -0
  562. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-yjIHlOGa.js +25 -0
  563. package/codeyam-cli/src/webserver/build/client/assets/{LibraryFunctionPreview-DXN1aCbt.js → LibraryFunctionPreview-Cq5o8jL4.js} +1 -1
  564. package/codeyam-cli/src/webserver/build/client/assets/{LoadingDots-BmEO4Lqa.js → LoadingDots-BvMu2i-g.js} +1 -1
  565. package/codeyam-cli/src/webserver/build/client/assets/{LogViewer-CI1VaB3F.js → LogViewer-kgBTLoJD.js} +1 -1
  566. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-BzPgx-xO.js +11 -0
  567. package/codeyam-cli/src/webserver/build/client/assets/{SafeScreenshot-DQddU4F4.js → SafeScreenshot-CwZrv-Ok.js} +1 -1
  568. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-BX2Ny2Qj.js +10 -0
  569. package/codeyam-cli/src/webserver/build/client/assets/{TruncatedFilePath-Dt7eySG0.js → TruncatedFilePath-CDpEprKa.js} +1 -1
  570. package/codeyam-cli/src/webserver/build/client/assets/_index-BRx8ZGZo.js +11 -0
  571. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-4S4yPfFw.js +27 -0
  572. package/codeyam-cli/src/webserver/build/client/assets/agent-transcripts-DHKuQSmR.js +17 -0
  573. package/codeyam-cli/src/webserver/build/client/assets/api.agent-transcripts-l0sNRNKZ.js +1 -0
  574. package/codeyam-cli/src/webserver/build/client/assets/api.health-l0sNRNKZ.js +1 -0
  575. package/codeyam-cli/src/webserver/build/client/assets/api.labs-unlock-l0sNRNKZ.js +1 -0
  576. package/codeyam-cli/src/webserver/build/client/assets/api.memory-profile-l0sNRNKZ.js +1 -0
  577. package/codeyam-cli/src/webserver/build/client/assets/api.restart-server-l0sNRNKZ.js +1 -0
  578. package/codeyam-cli/src/webserver/build/client/assets/api.save-fixture-l0sNRNKZ.js +1 -0
  579. package/codeyam-cli/src/webserver/build/client/assets/book-open-D4IPYH_y.js +6 -0
  580. package/codeyam-cli/src/webserver/build/client/assets/{chevron-down-ITTv_xL3.js → chevron-down-CG65viiV.js} +1 -1
  581. package/codeyam-cli/src/webserver/build/client/assets/chunk-JZWAC4HX-DB3aFuEO.js +51 -0
  582. package/codeyam-cli/src/webserver/build/client/assets/{circle-check-mMM0RzI0.js → circle-check-igfMr5DY.js} +1 -1
  583. package/codeyam-cli/src/webserver/build/client/assets/copy-Coc4o_8c.js +11 -0
  584. package/codeyam-cli/src/webserver/build/client/assets/{createLucideIcon-en9_3LGg.js → createLucideIcon-D1zB-pYc.js} +1 -1
  585. package/codeyam-cli/src/webserver/build/client/assets/{cy-logo-cli-C1gnJVOL.svg → cy-logo-cli-CCKUIm0S.svg} +2 -2
  586. package/codeyam-cli/src/webserver/build/client/assets/cy-logo-cli-DcX-ZS3p.js +1 -0
  587. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-JTAjQ54M.js +1 -0
  588. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha._-DBgKdrTR.js → entity._sha._-B0h9AqE6.js} +12 -12
  589. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-DjLxr2JB.js +6 -0
  590. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-CtYowLOt.js +6 -0
  591. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha_.edit._scenarioId-Sf59Z2Pa.js → entity._sha_.edit._scenarioId-PePWg17F.js} +2 -2
  592. package/codeyam-cli/src/webserver/build/client/assets/{entry.client-BvGka1gZ.js → entry.client-I-Wo99C_.js} +6 -6
  593. package/codeyam-cli/src/webserver/build/client/assets/executionFlowCoverage-BWhdfn70.js +1 -0
  594. package/codeyam-cli/src/webserver/build/client/assets/{fileTableUtils-_IuKNgFH.js → fileTableUtils-9sMMAiWJ.js} +1 -1
  595. package/codeyam-cli/src/webserver/build/client/assets/files-Co65J0s3.js +1 -0
  596. package/codeyam-cli/src/webserver/build/client/assets/{git-8zM4ebXo.js → git-BdHOxVfg.js} +8 -8
  597. package/codeyam-cli/src/webserver/build/client/assets/globals-BSZfYCkU.css +1 -0
  598. package/codeyam-cli/src/webserver/build/client/assets/{index-CkpJhcNC.js → index-CUM5iXwc.js} +1 -1
  599. package/codeyam-cli/src/webserver/build/client/assets/{index-DFbRIdR_.js → index-_417gcQW.js} +1 -1
  600. package/codeyam-cli/src/webserver/build/client/assets/labs-BK0C1H1T.js +1 -0
  601. package/codeyam-cli/src/webserver/build/client/assets/{loader-circle-DEtRABV3.js → loader-circle-TzRHMVog.js} +1 -1
  602. package/codeyam-cli/src/webserver/build/client/assets/manifest-040dab1c.js +1 -0
  603. package/codeyam-cli/src/webserver/build/client/assets/memory-UIDVz141.js +92 -0
  604. package/codeyam-cli/src/webserver/build/client/assets/pause-hjzB7t2z.js +11 -0
  605. package/codeyam-cli/src/webserver/build/client/assets/root-D1WadSdf.js +62 -0
  606. package/codeyam-cli/src/webserver/build/client/assets/{search-Clp3R4kH.js → search-DcAwD_Ln.js} +1 -1
  607. package/codeyam-cli/src/webserver/build/client/assets/settings-CclxrcPK.js +1 -0
  608. package/codeyam-cli/src/webserver/build/client/assets/simulations-DVNJVQgD.js +1 -0
  609. package/codeyam-cli/src/webserver/build/client/assets/terminal-DbEAHMbA.js +11 -0
  610. package/codeyam-cli/src/webserver/build/client/assets/{triangle-alert-CUVskfkL.js → triangle-alert-CAD5b1o_.js} +1 -1
  611. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-BqgrAzs3.js +1 -0
  612. package/codeyam-cli/src/webserver/build/client/assets/{useLastLogLine-CHT-Bzx5.js → useLastLogLine-DAFqfEDH.js} +1 -1
  613. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-DZlYx2c4.js +1 -0
  614. package/codeyam-cli/src/webserver/build/client/assets/{useToast-BCR_pi3-.js → useToast-ihdMtlf6.js} +1 -1
  615. package/codeyam-cli/src/webserver/build/server/assets/index-B3dE0r28.js +1 -0
  616. package/codeyam-cli/src/webserver/build/server/assets/server-build-DYbfdxa3.js +273 -0
  617. package/codeyam-cli/src/webserver/build/server/index.js +1 -1
  618. package/codeyam-cli/src/webserver/build-info.json +5 -5
  619. package/codeyam-cli/src/webserver/devServer.js +1 -3
  620. package/codeyam-cli/src/webserver/devServer.js.map +1 -1
  621. package/codeyam-cli/src/webserver/server.js +35 -25
  622. package/codeyam-cli/src/webserver/server.js.map +1 -1
  623. package/codeyam-cli/templates/{codeyam-debug-skill.md → codeyam-debug.md} +48 -4
  624. package/codeyam-cli/templates/codeyam-diagnose.md +481 -0
  625. package/codeyam-cli/templates/codeyam-memory-hook.sh +199 -0
  626. package/codeyam-cli/templates/codeyam-memory.md +396 -0
  627. package/codeyam-cli/templates/codeyam-new-rule.md +13 -0
  628. package/codeyam-cli/templates/{codeyam-setup-skill.md → codeyam-setup.md} +151 -4
  629. package/codeyam-cli/templates/{codeyam-sim-skill.md → codeyam-sim.md} +1 -1
  630. package/codeyam-cli/templates/{codeyam-test-skill.md → codeyam-test.md} +1 -1
  631. package/codeyam-cli/templates/{codeyam-verify-skill.md → codeyam-verify.md} +1 -1
  632. package/codeyam-cli/templates/rule-notification-hook.py +56 -0
  633. package/codeyam-cli/templates/rule-reflection-hook.py +627 -0
  634. package/codeyam-cli/templates/rules-instructions.md +132 -0
  635. package/package.json +18 -15
  636. package/packages/ai/index.js +8 -6
  637. package/packages/ai/index.js.map +1 -1
  638. package/packages/ai/src/lib/analyzeScope.js +179 -13
  639. package/packages/ai/src/lib/analyzeScope.js.map +1 -1
  640. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js +150 -0
  641. package/packages/ai/src/lib/astScopes/arrayDerivationDetector.js.map +1 -0
  642. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js +154 -9
  643. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js.map +1 -1
  644. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js +435 -0
  645. package/packages/ai/src/lib/astScopes/conditionalEffectsExtractor.js.map +1 -0
  646. package/packages/ai/src/lib/astScopes/methodSemantics.js +138 -23
  647. package/packages/ai/src/lib/astScopes/methodSemantics.js.map +1 -1
  648. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js +10 -14
  649. package/packages/ai/src/lib/astScopes/patterns/forInStatementHandler.js.map +1 -1
  650. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js +8 -0
  651. package/packages/ai/src/lib/astScopes/patterns/ifStatementHandler.js.map +1 -1
  652. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js +23 -0
  653. package/packages/ai/src/lib/astScopes/patterns/switchStatementHandler.js.map +1 -1
  654. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js +138 -1
  655. package/packages/ai/src/lib/astScopes/patterns/variableDeclarationHandler.js.map +1 -1
  656. package/packages/ai/src/lib/astScopes/processExpression.js +1137 -96
  657. package/packages/ai/src/lib/astScopes/processExpression.js.map +1 -1
  658. package/packages/ai/src/lib/astScopes/sharedPatterns.js +25 -0
  659. package/packages/ai/src/lib/astScopes/sharedPatterns.js.map +1 -1
  660. package/packages/ai/src/lib/checkAllAttributes.js +24 -9
  661. package/packages/ai/src/lib/checkAllAttributes.js.map +1 -1
  662. package/packages/ai/src/lib/completionCall.js +178 -31
  663. package/packages/ai/src/lib/completionCall.js.map +1 -1
  664. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js +1741 -208
  665. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js.map +1 -1
  666. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js +7 -2
  667. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/JavascriptFrameworkManager.js.map +1 -1
  668. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js +230 -23
  669. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js.map +1 -1
  670. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js +77 -55
  671. package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js.map +1 -1
  672. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js +13 -3
  673. package/packages/ai/src/lib/dataStructure/helpers/BatchSchemaProcessor.js.map +1 -1
  674. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js +6 -4
  675. package/packages/ai/src/lib/dataStructure/helpers/ScopeTreeManager.js.map +1 -1
  676. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js +52 -3
  677. package/packages/ai/src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js.map +1 -1
  678. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js +139 -13
  679. package/packages/ai/src/lib/dataStructure/helpers/cleanNonObjectFunctions.js.map +1 -1
  680. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js +63 -0
  681. package/packages/ai/src/lib/dataStructure/helpers/coerceObjectsToPrimitivesBySchema.js.map +1 -0
  682. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js +142 -12
  683. package/packages/ai/src/lib/dataStructure/helpers/convertDotNotation.js.map +1 -1
  684. package/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.js +86 -0
  685. package/packages/ai/src/lib/dataStructure/helpers/convertNullToUndefinedBySchema.js.map +1 -0
  686. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js +173 -0
  687. package/packages/ai/src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js.map +1 -0
  688. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js +37 -20
  689. package/packages/ai/src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js.map +1 -1
  690. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js +334 -79
  691. package/packages/ai/src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js.map +1 -1
  692. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js +107 -0
  693. package/packages/ai/src/lib/dataStructure/helpers/fixNullIdsBySchema.js.map +1 -0
  694. package/packages/ai/src/lib/dataStructureChunking.js +130 -0
  695. package/packages/ai/src/lib/dataStructureChunking.js.map +1 -0
  696. package/packages/ai/src/lib/deepEqual.js +32 -0
  697. package/packages/ai/src/lib/deepEqual.js.map +1 -0
  698. package/packages/ai/src/lib/e2eDataTracking.js +241 -0
  699. package/packages/ai/src/lib/e2eDataTracking.js.map +1 -0
  700. package/packages/ai/src/lib/extractCriticalDataKeys.js +96 -0
  701. package/packages/ai/src/lib/extractCriticalDataKeys.js.map +1 -0
  702. package/packages/ai/src/lib/generateChangesEntityScenarioData.js +62 -5
  703. package/packages/ai/src/lib/generateChangesEntityScenarioData.js.map +1 -1
  704. package/packages/ai/src/lib/generateChangesEntityScenarios.js +81 -90
  705. package/packages/ai/src/lib/generateChangesEntityScenarios.js.map +1 -1
  706. package/packages/ai/src/lib/generateEntityDataStructure.js +47 -2
  707. package/packages/ai/src/lib/generateEntityDataStructure.js.map +1 -1
  708. package/packages/ai/src/lib/generateEntityScenarioData.js +1128 -85
  709. package/packages/ai/src/lib/generateEntityScenarioData.js.map +1 -1
  710. package/packages/ai/src/lib/generateEntityScenarios.js +193 -83
  711. package/packages/ai/src/lib/generateEntityScenarios.js.map +1 -1
  712. package/packages/ai/src/lib/generateExecutionFlows.js +495 -0
  713. package/packages/ai/src/lib/generateExecutionFlows.js.map +1 -0
  714. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js +380 -0
  715. package/packages/ai/src/lib/generateExecutionFlowsFromConditionalEffects.js.map +1 -0
  716. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js +1807 -0
  717. package/packages/ai/src/lib/generateExecutionFlowsFromConditionals.js.map +1 -0
  718. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js +194 -0
  719. package/packages/ai/src/lib/generateExecutionFlowsFromJsxUsages.js.map +1 -0
  720. package/packages/ai/src/lib/getConditionalUsagesFromCode.js +84 -14
  721. package/packages/ai/src/lib/getConditionalUsagesFromCode.js.map +1 -1
  722. package/packages/ai/src/lib/guessScenarioDataFromDescription.js +2 -1
  723. package/packages/ai/src/lib/guessScenarioDataFromDescription.js.map +1 -1
  724. package/packages/ai/src/lib/isolateScopes.js +270 -7
  725. package/packages/ai/src/lib/isolateScopes.js.map +1 -1
  726. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js +5 -0
  727. package/packages/ai/src/lib/mergeJsonTypeDefinitions.js.map +1 -1
  728. package/packages/ai/src/lib/mergeStatements.js +88 -46
  729. package/packages/ai/src/lib/mergeStatements.js.map +1 -1
  730. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js +97 -0
  731. package/packages/ai/src/lib/promptGenerators/collapseNullableObjects.js.map +1 -0
  732. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js +16 -4
  733. package/packages/ai/src/lib/promptGenerators/gatherAttributesMap.js.map +1 -1
  734. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js +1 -1
  735. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenarioDataGenerator.js.map +1 -1
  736. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js +21 -64
  737. package/packages/ai/src/lib/promptGenerators/generateChangesEntityScenariosGenerator.js.map +1 -1
  738. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js +54 -0
  739. package/packages/ai/src/lib/promptGenerators/generateChunkPrompt.js.map +1 -0
  740. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js +83 -6
  741. package/packages/ai/src/lib/promptGenerators/generateEntityScenarioDataGenerator.js.map +1 -1
  742. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js +10 -34
  743. package/packages/ai/src/lib/promptGenerators/generateEntityScenariosGenerator.js.map +1 -1
  744. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js +45 -0
  745. package/packages/ai/src/lib/promptGenerators/generateMissingKeysPrompt.js.map +1 -0
  746. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js +16 -3
  747. package/packages/ai/src/lib/promptGenerators/guessNewScenarioDataFromDescriptionGenerator.js.map +1 -1
  748. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js +335 -0
  749. package/packages/ai/src/lib/promptGenerators/simplifyKeysForLLM.js.map +1 -0
  750. package/packages/ai/src/lib/resolvePathToControllable.js +677 -0
  751. package/packages/ai/src/lib/resolvePathToControllable.js.map +1 -0
  752. package/packages/ai/src/lib/splitOutsideParentheses.js +3 -1
  753. package/packages/ai/src/lib/splitOutsideParentheses.js.map +1 -1
  754. package/packages/ai/src/lib/worker/SerializableDataStructure.js +29 -0
  755. package/packages/ai/src/lib/worker/SerializableDataStructure.js.map +1 -1
  756. package/packages/ai/src/lib/worker/analyzeScopeWorker.js +94 -1
  757. package/packages/ai/src/lib/worker/analyzeScopeWorker.js.map +1 -1
  758. package/packages/analyze/index.js +1 -0
  759. package/packages/analyze/index.js.map +1 -1
  760. package/packages/analyze/src/lib/FileAnalyzer.js +75 -36
  761. package/packages/analyze/src/lib/FileAnalyzer.js.map +1 -1
  762. package/packages/analyze/src/lib/ProjectAnalyzer.js +96 -26
  763. package/packages/analyze/src/lib/ProjectAnalyzer.js.map +1 -1
  764. package/packages/analyze/src/lib/analysisContext.js +30 -5
  765. package/packages/analyze/src/lib/analysisContext.js.map +1 -1
  766. package/packages/analyze/src/lib/asts/nodes/index.js +1 -0
  767. package/packages/analyze/src/lib/asts/nodes/index.js.map +1 -1
  768. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js +52 -0
  769. package/packages/analyze/src/lib/asts/nodes/isAsyncFunction.js.map +1 -0
  770. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js +14 -0
  771. package/packages/analyze/src/lib/asts/sourceFiles/getAllDeclaredEntityNodes.js.map +1 -1
  772. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js +14 -0
  773. package/packages/analyze/src/lib/asts/sourceFiles/getAllEntityNodes.js.map +1 -1
  774. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js +6 -0
  775. package/packages/analyze/src/lib/asts/sourceFiles/getAllExports.js.map +1 -1
  776. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js +6 -0
  777. package/packages/analyze/src/lib/asts/sourceFiles/getImportsAnalysis.js.map +1 -1
  778. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js +39 -1
  779. package/packages/analyze/src/lib/asts/sourceFiles/getResolvedModule.js.map +1 -1
  780. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js +2 -1
  781. package/packages/analyze/src/lib/asts/sourceFiles/getSourceFilesForAllImports.js.map +1 -1
  782. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js +268 -52
  783. package/packages/analyze/src/lib/files/analyze/analyzeEntities/prepareDataStructures.js.map +1 -1
  784. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js +24 -1
  785. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js.map +1 -1
  786. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js +5 -0
  787. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js.map +1 -1
  788. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js +2 -0
  789. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js.map +1 -1
  790. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js +2 -1
  791. package/packages/analyze/src/lib/files/analyze/gatherEntityMap.js.map +1 -1
  792. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js +31 -10
  793. package/packages/analyze/src/lib/files/analyze/validateDependencyAnalyses.js.map +1 -1
  794. package/packages/analyze/src/lib/files/analyzeChange.js +21 -11
  795. package/packages/analyze/src/lib/files/analyzeChange.js.map +1 -1
  796. package/packages/analyze/src/lib/files/analyzeEntity.js +9 -8
  797. package/packages/analyze/src/lib/files/analyzeEntity.js.map +1 -1
  798. package/packages/analyze/src/lib/files/analyzeInitial.js +9 -10
  799. package/packages/analyze/src/lib/files/analyzeInitial.js.map +1 -1
  800. package/packages/analyze/src/lib/files/analyzeRemixRoute.js +3 -2
  801. package/packages/analyze/src/lib/files/analyzeRemixRoute.js.map +1 -1
  802. package/packages/analyze/src/lib/files/enums/steps.js +1 -1
  803. package/packages/analyze/src/lib/files/enums/steps.js.map +1 -1
  804. package/packages/analyze/src/lib/files/getImportedExports.js +11 -7
  805. package/packages/analyze/src/lib/files/getImportedExports.js.map +1 -1
  806. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js +880 -0
  807. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js.map +1 -0
  808. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js +170 -40
  809. package/packages/analyze/src/lib/files/scenarios/enrichArrayTypesFromChildSignatures.js.map +1 -1
  810. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js +85 -0
  811. package/packages/analyze/src/lib/files/scenarios/enrichUnknownTypesFromSourceEquivalencies.js.map +1 -0
  812. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js +522 -59
  813. package/packages/analyze/src/lib/files/scenarios/gatherDataForMocks.js.map +1 -1
  814. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.js +1 -1
  815. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarioData.js.map +1 -1
  816. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js +29 -34
  817. package/packages/analyze/src/lib/files/scenarios/generateChangesScenarios.js.map +1 -1
  818. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js +268 -51
  819. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js.map +1 -1
  820. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js +144 -0
  821. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js.map +1 -0
  822. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js +56 -69
  823. package/packages/analyze/src/lib/files/scenarios/generateScenarioData.js.map +1 -1
  824. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js +4 -8
  825. package/packages/analyze/src/lib/files/scenarios/generateScenarios.js.map +1 -1
  826. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js +801 -118
  827. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js.map +1 -1
  828. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js +46 -9
  829. package/packages/analyze/src/lib/files/scenarios/mergeValidatedDataStructures.js.map +1 -1
  830. package/packages/analyze/src/lib/files/setImportedExports.js +2 -1
  831. package/packages/analyze/src/lib/files/setImportedExports.js.map +1 -1
  832. package/packages/analyze/src/lib/index.js +1 -0
  833. package/packages/analyze/src/lib/index.js.map +1 -1
  834. package/packages/analyze/src/lib/utils/getFileByPath.js +12 -0
  835. package/packages/analyze/src/lib/utils/getFileByPath.js.map +1 -0
  836. package/packages/aws/src/lib/ecs/ecsDefineContainer.js +2 -2
  837. package/packages/aws/src/lib/ecs/ecsDefineContainer.js.map +1 -1
  838. package/packages/aws/src/lib/ecs/ecsTaskFactory.js +17 -61
  839. package/packages/aws/src/lib/ecs/ecsTaskFactory.js.map +1 -1
  840. package/packages/database/src/lib/analysisBranchToDb.js +1 -1
  841. package/packages/database/src/lib/analysisBranchToDb.js.map +1 -1
  842. package/packages/database/src/lib/analysisToDb.js +1 -1
  843. package/packages/database/src/lib/analysisToDb.js.map +1 -1
  844. package/packages/database/src/lib/branchToDb.js +1 -1
  845. package/packages/database/src/lib/branchToDb.js.map +1 -1
  846. package/packages/database/src/lib/commitBranchToDb.js +1 -1
  847. package/packages/database/src/lib/commitBranchToDb.js.map +1 -1
  848. package/packages/database/src/lib/commitToDb.js +1 -1
  849. package/packages/database/src/lib/commitToDb.js.map +1 -1
  850. package/packages/database/src/lib/fileToDb.js +1 -1
  851. package/packages/database/src/lib/fileToDb.js.map +1 -1
  852. package/packages/database/src/lib/kysely/db.js +13 -3
  853. package/packages/database/src/lib/kysely/db.js.map +1 -1
  854. package/packages/database/src/lib/kysely/tables/commitsTable.js +3 -0
  855. package/packages/database/src/lib/kysely/tables/commitsTable.js.map +1 -1
  856. package/packages/database/src/lib/kysely/tables/debugReportsTable.js +9 -3
  857. package/packages/database/src/lib/kysely/tables/debugReportsTable.js.map +1 -1
  858. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js +35 -0
  859. package/packages/database/src/lib/kysely/tables/labsRequestsTable.js.map +1 -0
  860. package/packages/database/src/lib/loadAnalyses.js +45 -2
  861. package/packages/database/src/lib/loadAnalyses.js.map +1 -1
  862. package/packages/database/src/lib/loadAnalysis.js +8 -0
  863. package/packages/database/src/lib/loadAnalysis.js.map +1 -1
  864. package/packages/database/src/lib/loadBranch.js +11 -1
  865. package/packages/database/src/lib/loadBranch.js.map +1 -1
  866. package/packages/database/src/lib/loadCommit.js +7 -0
  867. package/packages/database/src/lib/loadCommit.js.map +1 -1
  868. package/packages/database/src/lib/loadCommits.js +22 -1
  869. package/packages/database/src/lib/loadCommits.js.map +1 -1
  870. package/packages/database/src/lib/loadEntities.js +23 -4
  871. package/packages/database/src/lib/loadEntities.js.map +1 -1
  872. package/packages/database/src/lib/loadEntityBranches.js +9 -0
  873. package/packages/database/src/lib/loadEntityBranches.js.map +1 -1
  874. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js +7 -4
  875. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  876. package/packages/database/src/lib/projectToDb.js +1 -1
  877. package/packages/database/src/lib/projectToDb.js.map +1 -1
  878. package/packages/database/src/lib/saveFiles.js +1 -1
  879. package/packages/database/src/lib/saveFiles.js.map +1 -1
  880. package/packages/database/src/lib/scenarioToDb.js +1 -1
  881. package/packages/database/src/lib/scenarioToDb.js.map +1 -1
  882. package/packages/database/src/lib/updateCommitMetadata.js +5 -4
  883. package/packages/database/src/lib/updateCommitMetadata.js.map +1 -1
  884. package/packages/generate/index.js +3 -0
  885. package/packages/generate/index.js.map +1 -1
  886. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js +16 -1
  887. package/packages/generate/src/lib/componentScenarioPage/componentScenarioPageNext.js.map +1 -1
  888. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +189 -0
  889. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -0
  890. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js +53 -0
  891. package/packages/generate/src/lib/componentScenarioPage/generateScenarioServerComponent.js.map +1 -0
  892. package/packages/generate/src/lib/deepMerge.js +27 -1
  893. package/packages/generate/src/lib/deepMerge.js.map +1 -1
  894. package/packages/generate/src/lib/scenarioComponentForServer.js +89 -0
  895. package/packages/generate/src/lib/scenarioComponentForServer.js.map +1 -0
  896. package/packages/github/src/lib/loadOrCreateCommit.js +10 -0
  897. package/packages/github/src/lib/loadOrCreateCommit.js.map +1 -1
  898. package/packages/github/src/lib/syncPrimaryBranch.js +3 -0
  899. package/packages/github/src/lib/syncPrimaryBranch.js.map +1 -1
  900. package/packages/process/index.js +3 -0
  901. package/packages/process/index.js.map +1 -0
  902. package/packages/process/src/GlobalProcessManager.js.map +1 -0
  903. package/{background/src/lib/process → packages/process/src}/ProcessManager.js +1 -1
  904. package/packages/process/src/ProcessManager.js.map +1 -0
  905. package/packages/process/src/index.js.map +1 -0
  906. package/packages/process/src/managedExecAsync.js.map +1 -0
  907. package/packages/types/index.js.map +1 -1
  908. package/packages/utils/src/lib/fs/rsyncCopy.js +93 -2
  909. package/packages/utils/src/lib/fs/rsyncCopy.js.map +1 -1
  910. package/packages/utils/src/lib/safeFileName.js +29 -3
  911. package/packages/utils/src/lib/safeFileName.js.map +1 -1
  912. package/scripts/finalize-analyzer.cjs +8 -76
  913. package/analyzer-template/packages/ai/src/lib/findMatchingAttribute.ts +0 -102
  914. package/analyzer-template/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.ts +0 -197
  915. package/analyzer-template/packages/ai/src/lib/generateChangesEntityKeyAttributes.ts +0 -271
  916. package/analyzer-template/packages/ai/src/lib/generateEntityKeyAttributes.ts +0 -294
  917. package/analyzer-template/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.ts +0 -67
  918. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.ts +0 -115
  919. package/analyzer-template/process/INTEGRATION_COMPLETE.md +0 -333
  920. package/analyzer-template/process/INTEGRATION_EXAMPLE.md +0 -525
  921. package/analyzer-template/process/README.md +0 -507
  922. package/background/src/lib/process/GlobalProcessManager.js.map +0 -1
  923. package/background/src/lib/process/ProcessManager.js.map +0 -1
  924. package/background/src/lib/process/index.js.map +0 -1
  925. package/background/src/lib/process/managedExecAsync.js.map +0 -1
  926. package/codeyam-cli/scripts/fixtures/cal.com/universal-mocks/packages/prisma/index.js +0 -238
  927. package/codeyam-cli/scripts/fixtures/cal.com/universal-mocks/packages/prisma/index.js.map +0 -1
  928. package/codeyam-cli/scripts/fixtures/formbricks/universal-mocks/apps/web/lib/instance/service.js +0 -7
  929. package/codeyam-cli/scripts/fixtures/formbricks/universal-mocks/apps/web/lib/instance/service.js.map +0 -1
  930. package/codeyam-cli/src/webserver/build/client/assets/EntityItem-DpUOH11S.js +0 -1
  931. package/codeyam-cli/src/webserver/build/client/assets/EntityTypeIcon-Cxs_KUEt.js +0 -41
  932. package/codeyam-cli/src/webserver/build/client/assets/InteractivePreview-D_gPUolj.js +0 -25
  933. package/codeyam-cli/src/webserver/build/client/assets/ReportIssueModal-MbTu_hOR.js +0 -11
  934. package/codeyam-cli/src/webserver/build/client/assets/ScenarioViewer-Diqfd5nO.js +0 -15
  935. package/codeyam-cli/src/webserver/build/client/assets/_index-D0tNX0Y7.js +0 -11
  936. package/codeyam-cli/src/webserver/build/client/assets/activity.(_tab)-CV8R8fpo.js +0 -32
  937. package/codeyam-cli/src/webserver/build/client/assets/chunk-JMJ3UQ3L-Tv-88Jsz.js +0 -51
  938. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-Cw7TE00E.js +0 -1
  939. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-DUOKD0lj.js +0 -1
  940. package/codeyam-cli/src/webserver/build/client/assets/files-DMW0hD4L.js +0 -1
  941. package/codeyam-cli/src/webserver/build/client/assets/globals-D3y4cv7l.css +0 -1
  942. package/codeyam-cli/src/webserver/build/client/assets/manifest-18ff0544.js +0 -1
  943. package/codeyam-cli/src/webserver/build/client/assets/root-BuQ6JiJU.js +0 -51
  944. package/codeyam-cli/src/webserver/build/client/assets/settings-DzIyX7wI.js +0 -1
  945. package/codeyam-cli/src/webserver/build/client/assets/simulations-BKNqbrwU.js +0 -1
  946. package/codeyam-cli/src/webserver/build/client/assets/useReportContext-By4FnEmE.js +0 -1
  947. package/codeyam-cli/src/webserver/build/server/assets/index-CzKXayO4.js +0 -1
  948. package/codeyam-cli/src/webserver/build/server/assets/server-build-CHRMAMo8.js +0 -166
  949. package/codeyam-cli/templates/debug-codeyam.md +0 -576
  950. package/packages/ai/src/lib/findMatchingAttribute.js +0 -77
  951. package/packages/ai/src/lib/findMatchingAttribute.js.map +0 -1
  952. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js +0 -136
  953. package/packages/ai/src/lib/gatherRelevantDependentKeyAttributes.js.map +0 -1
  954. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js +0 -220
  955. package/packages/ai/src/lib/generateChangesEntityKeyAttributes.js.map +0 -1
  956. package/packages/ai/src/lib/generateEntityKeyAttributes.js +0 -241
  957. package/packages/ai/src/lib/generateEntityKeyAttributes.js.map +0 -1
  958. package/packages/ai/src/lib/isFrontend.js +0 -5
  959. package/packages/ai/src/lib/isFrontend.js.map +0 -1
  960. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js +0 -40
  961. package/packages/ai/src/lib/promptGenerators/generateEntityKeyAttributesGenerator.js.map +0 -1
  962. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js +0 -72
  963. package/packages/analyze/src/lib/files/scenarios/generateKeyAttributes.js.map +0 -1
  964. /package/analyzer-template/{process → packages/process/src}/GlobalProcessManager.ts +0 -0
  965. /package/analyzer-template/{process → packages/process/src}/ProcessManager.ts +0 -0
  966. /package/analyzer-template/{process → packages/process/src}/index.ts +0 -0
  967. /package/analyzer-template/{process → packages/process/src}/managedExecAsync.ts +0 -0
  968. /package/{background/src/lib/process → packages/process/src}/GlobalProcessManager.js +0 -0
  969. /package/{background/src/lib/process → packages/process/src}/index.js +0 -0
  970. /package/{background/src/lib/process → packages/process/src}/managedExecAsync.js +0 -0
@@ -1,9 +1,15 @@
1
1
  import ts from 'typescript';
2
- import { AnalysisContext, ConditionalUsage } from './types';
2
+ import * as crypto from 'crypto';
3
+ import {
4
+ AnalysisContext,
5
+ CompoundConditional,
6
+ ConditionalUsage,
7
+ } from './types';
3
8
  import { StructuredPath } from './paths';
4
9
  import { nodeToSource } from './nodeToSource';
5
10
  import { methodRegistry, ArrayPushSemantics } from './methodSemantics';
6
11
  import {
12
+ getComparisonOperatorString,
7
13
  isArithmeticOperator,
8
14
  isAssignmentOperator,
9
15
  isBitwiseCompoundOperator,
@@ -14,6 +20,333 @@ import {
14
20
  unwrapExpression,
15
21
  } from './sharedPatterns';
16
22
  import { processBindingPattern } from './processBindings';
23
+ import {
24
+ extractConditionalEffectsFromTernary,
25
+ findUseStateSetters,
26
+ } from './conditionalEffectsExtractor';
27
+ import { detectArrayDerivedPattern } from './arrayDerivationDetector';
28
+
29
+ /**
30
+ * Recursively extracts root variable names from an expression AST node.
31
+ * Used to identify which variables flow into JSX expression children,
32
+ * so we can link them to the return value schema.
33
+ *
34
+ * Examples:
35
+ * - `filteredTopPaths.map(...)` → ['filteredTopPaths']
36
+ * - `a && b` → ['a', 'b']
37
+ * - `condition ? x : y` → ['condition', 'x', 'y']
38
+ */
39
+ function extractRootVariableNames(node: ts.Expression): string[] {
40
+ const ignoredIdentifiers = new Set([
41
+ 'undefined',
42
+ 'null',
43
+ 'true',
44
+ 'false',
45
+ 'NaN',
46
+ 'Infinity',
47
+ ]);
48
+
49
+ if (ts.isIdentifier(node)) {
50
+ const name = node.text;
51
+ return ignoredIdentifiers.has(name) ? [] : [name];
52
+ }
53
+
54
+ if (ts.isPropertyAccessExpression(node)) {
55
+ return extractRootVariableNames(node.expression);
56
+ }
57
+
58
+ if (ts.isCallExpression(node)) {
59
+ return extractRootVariableNames(node.expression);
60
+ }
61
+
62
+ if (ts.isBinaryExpression(node)) {
63
+ return [
64
+ ...extractRootVariableNames(node.left),
65
+ ...extractRootVariableNames(node.right),
66
+ ];
67
+ }
68
+
69
+ if (ts.isPrefixUnaryExpression(node)) {
70
+ return extractRootVariableNames(node.operand);
71
+ }
72
+
73
+ if (ts.isConditionalExpression(node)) {
74
+ return [
75
+ ...extractRootVariableNames(node.condition),
76
+ ...extractRootVariableNames(node.whenTrue),
77
+ ...extractRootVariableNames(node.whenFalse),
78
+ ];
79
+ }
80
+
81
+ if (ts.isParenthesizedExpression(node)) {
82
+ return extractRootVariableNames(node.expression);
83
+ }
84
+
85
+ // Stop recursion at JSX elements and other terminal nodes
86
+ if (
87
+ ts.isJsxElement(node) ||
88
+ ts.isJsxFragment(node) ||
89
+ ts.isJsxSelfClosingElement(node)
90
+ ) {
91
+ return [];
92
+ }
93
+
94
+ return [];
95
+ }
96
+
97
+ /**
98
+ * Checks if a JSX element has props that reference variables from the parent scope.
99
+ * This is used to detect unconditionally-rendered children that should have their
100
+ * execution flows merged into the parent.
101
+ *
102
+ * We want to track children where the parent controls data that affects the child's
103
+ * conditional rendering. Static props (like title="Dashboard") don't need tracking
104
+ * because they don't create variable execution flows.
105
+ *
106
+ * Examples:
107
+ * - <WorkoutsView workouts={workouts} /> → true (workouts is a variable)
108
+ * - <ItemList items={items} count={count} /> → true (items, count are variables)
109
+ * - <Header title="Dashboard" /> → false (static string)
110
+ * - <Footer /> → false (no props)
111
+ * - <Button onClick={handleClick} /> → false (only callback, no data props)
112
+ *
113
+ * @returns true if the component has at least one prop that references a variable
114
+ * (excluding callbacks which typically start with 'on' or 'handle')
115
+ */
116
+ function hasDataPropsFromParent(
117
+ node: ts.JsxElement | ts.JsxSelfClosingElement,
118
+ componentName: string,
119
+ ): { hasDataProps: boolean; dataProps: string[] } {
120
+ const attributes = ts.isJsxElement(node)
121
+ ? node.openingElement.attributes.properties
122
+ : node.attributes.properties;
123
+
124
+ const dataProps: string[] = [];
125
+
126
+ for (const attr of attributes) {
127
+ // Spread attributes always reference parent data: {...props}
128
+ if (ts.isJsxSpreadAttribute(attr)) {
129
+ const spreadText = attr.expression?.getText() || '...spread';
130
+ dataProps.push(`{...${spreadText}}`);
131
+ console.log(
132
+ `[UnconditionalChild] ${componentName}: Found spread attribute {${spreadText}}`,
133
+ );
134
+ continue;
135
+ }
136
+
137
+ if (ts.isJsxAttribute(attr)) {
138
+ const propName = attr.name.getText();
139
+
140
+ // Skip callback props - they don't create data-driven execution flows
141
+ // Callbacks typically start with 'on' (onClick, onChange) or 'handle' (handleSubmit)
142
+ if (
143
+ propName.startsWith('on') ||
144
+ propName.startsWith('handle') ||
145
+ propName === 'ref'
146
+ ) {
147
+ console.log(
148
+ `[UnconditionalChild] ${componentName}: Skipping callback prop '${propName}'`,
149
+ );
150
+ continue;
151
+ }
152
+
153
+ // Check if the prop value is a JSX expression (references a variable)
154
+ // vs a string literal which is static
155
+ if (attr.initializer) {
156
+ if (ts.isJsxExpression(attr.initializer)) {
157
+ // JSX expression like prop={value} - this references a variable
158
+ // Could be a simple identifier, property access, or more complex expression
159
+ const expression = attr.initializer.expression;
160
+ if (expression) {
161
+ // Skip if it's just a function/arrow function (callback)
162
+ if (
163
+ ts.isArrowFunction(expression) ||
164
+ ts.isFunctionExpression(expression)
165
+ ) {
166
+ console.log(
167
+ `[UnconditionalChild] ${componentName}: Skipping inline callback prop '${propName}'`,
168
+ );
169
+ continue;
170
+ }
171
+ // This is a data prop that references parent state/props
172
+ const exprText = expression.getText();
173
+ dataProps.push(`${propName}={${exprText}}`);
174
+ console.log(
175
+ `[UnconditionalChild] ${componentName}: Found data prop '${propName}' = {${exprText}}`,
176
+ );
177
+ }
178
+ } else {
179
+ // String literals like prop="value" are static
180
+ console.log(
181
+ `[UnconditionalChild] ${componentName}: Skipping static prop '${propName}'`,
182
+ );
183
+ }
184
+ }
185
+ }
186
+ }
187
+
188
+ const hasDataProps = dataProps.length > 0;
189
+ if (hasDataProps) {
190
+ console.log(
191
+ `[UnconditionalChild] ${componentName}: Has ${dataProps.length} data props: [${dataProps.join(', ')}]`,
192
+ );
193
+ } else {
194
+ console.log(
195
+ `[UnconditionalChild] ${componentName}: No data props found, will NOT track`,
196
+ );
197
+ }
198
+
199
+ return { hasDataProps, dataProps };
200
+ }
201
+
202
+ /**
203
+ * Extracts the component name from a JSX element.
204
+ * Returns null for intrinsic elements (div, span, etc.) since we only care about
205
+ * custom components for gating condition tracking.
206
+ *
207
+ * Examples:
208
+ * - <ChildViewer /> → "ChildViewer"
209
+ * - <ScenarioViewer scenario={...} /> → "ScenarioViewer"
210
+ * - <div> → null (intrinsic element)
211
+ */
212
+ function getComponentNameFromJsx(
213
+ node: ts.JsxElement | ts.JsxSelfClosingElement,
214
+ ): string | null {
215
+ let tagName: ts.JsxTagNameExpression;
216
+
217
+ if (ts.isJsxElement(node)) {
218
+ tagName = node.openingElement.tagName;
219
+ } else {
220
+ tagName = node.tagName;
221
+ }
222
+
223
+ // Get the text of the tag name
224
+ const name = tagName.getText();
225
+
226
+ // Check if it's a custom component (starts with uppercase) vs intrinsic element
227
+ // Custom components start with uppercase: <MyComponent />
228
+ // Intrinsic elements start with lowercase: <div />
229
+ if (
230
+ name &&
231
+ name[0] === name[0].toUpperCase() &&
232
+ name[0] !== name[0].toLowerCase()
233
+ ) {
234
+ return name;
235
+ }
236
+
237
+ return null;
238
+ }
239
+
240
+ /**
241
+ * Extracts condition paths from a logical AND chain expression.
242
+ * Used for creating gating conditions for child components.
243
+ *
244
+ * Example: `hasData && isReady && <Component />` returns ['hasData', 'isReady']
245
+ */
246
+ function extractConditionPathsFromAndChain(
247
+ expr: ts.Expression,
248
+ sourceFile: ts.SourceFile,
249
+ ): string[] {
250
+ const paths: string[] = [];
251
+ const unwrapped = unwrapExpression(expr);
252
+
253
+ if (
254
+ ts.isBinaryExpression(unwrapped) &&
255
+ unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
256
+ ) {
257
+ // Recursively get conditions from left side
258
+ paths.push(
259
+ ...extractConditionPathsFromAndChain(unwrapped.left, sourceFile),
260
+ );
261
+
262
+ // Process right side if it's not JSX (JSX is the consequence, not a condition)
263
+ const rightUnwrapped = unwrapExpression(unwrapped.right);
264
+ if (
265
+ !ts.isJsxElement(rightUnwrapped) &&
266
+ !ts.isJsxSelfClosingElement(rightUnwrapped) &&
267
+ !ts.isJsxFragment(rightUnwrapped)
268
+ ) {
269
+ paths.push(
270
+ ...extractConditionPathsFromAndChain(unwrapped.right, sourceFile),
271
+ );
272
+ }
273
+ } else {
274
+ // Base case: extract path from this expression
275
+ const path = StructuredPath.fromNode(unwrapped, sourceFile);
276
+ if (path) {
277
+ paths.push(path.toString());
278
+ }
279
+ }
280
+
281
+ return paths;
282
+ }
283
+
284
+ /**
285
+ * Finds the rightmost JSX element in an && chain.
286
+ * Example: `a && b && <Component />` returns <Component />
287
+ */
288
+ function findJsxInAndChain(
289
+ expr: ts.Expression,
290
+ ): ts.JsxElement | ts.JsxSelfClosingElement | null {
291
+ const unwrapped = unwrapExpression(expr);
292
+
293
+ if (ts.isJsxElement(unwrapped) || ts.isJsxSelfClosingElement(unwrapped)) {
294
+ return unwrapped;
295
+ }
296
+
297
+ if (
298
+ ts.isBinaryExpression(unwrapped) &&
299
+ unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
300
+ ) {
301
+ // Check right side first (most common case: condition && <Jsx />)
302
+ const rightResult = findJsxInAndChain(unwrapped.right);
303
+ if (rightResult) return rightResult;
304
+
305
+ // Also check left side for rare cases
306
+ return findJsxInAndChain(unwrapped.left);
307
+ }
308
+
309
+ return null;
310
+ }
311
+
312
+ /**
313
+ * Fix 32: Finds a JSX fragment in an && chain.
314
+ * Example: `activeTab && <><ChildA /><ChildB /></>` returns the fragment
315
+ * This is needed to propagate parent conditions through fragments.
316
+ */
317
+ function findJsxFragmentInAndChain(expr: ts.Expression): ts.JsxFragment | null {
318
+ const unwrapped = unwrapExpression(expr);
319
+
320
+ if (ts.isJsxFragment(unwrapped)) {
321
+ return unwrapped;
322
+ }
323
+
324
+ if (
325
+ ts.isBinaryExpression(unwrapped) &&
326
+ unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
327
+ ) {
328
+ // Check right side first (most common case: condition && <></>)
329
+ const rightResult = findJsxFragmentInAndChain(unwrapped.right);
330
+ if (rightResult) return rightResult;
331
+
332
+ // Also check left side for rare cases
333
+ return findJsxFragmentInAndChain(unwrapped.left);
334
+ }
335
+
336
+ return null;
337
+ }
338
+
339
+ /**
340
+ * Detects if a property access looks like an environment variable store access.
341
+ * Matches patterns like `env.DATABASE_URL`, `env.IS_FORMBRICKS_CLOUD`, etc.
342
+ * where the object is named "env" and the property looks like an env var name.
343
+ */
344
+ function isEnvStoreAccess(fullText: string): boolean {
345
+ // Match: env.SOME_VAR or env.someVar (but object must be exactly "env")
346
+ // This catches patterns from @t3-oss/env-nextjs and similar packages
347
+ const envStorePattern = /^env\.[A-Z_][A-Z0-9_]*$/;
348
+ return envStorePattern.test(fullText);
349
+ }
17
350
 
18
351
  /**
19
352
  * Converts a call expression argument to a StructuredPath.
@@ -190,131 +523,1014 @@ export function markConditionVariablesAsNullable(
190
523
  }
191
524
 
192
525
  /**
193
- * Extracts conditional usages from a condition expression for key attribute detection.
194
- * This function identifies which attributes are used in conditionals and how they're used.
526
+ * Helper to extract source location from an AST node
527
+ */
528
+ function getSourceLocation(
529
+ node: ts.Node,
530
+ sourceFile: ts.SourceFile,
531
+ ): ConditionalUsage['sourceLocation'] {
532
+ const start = node.getStart(sourceFile);
533
+ const { line, character } = sourceFile.getLineAndCharacterOfPosition(start);
534
+ const codeSnippet = node.getText(sourceFile);
535
+
536
+ return {
537
+ lineNumber: line + 1, // Convert to 1-based
538
+ column: character,
539
+ codeSnippet:
540
+ codeSnippet.length > 100
541
+ ? codeSnippet.slice(0, 100) + '...'
542
+ : codeSnippet,
543
+ };
544
+ }
545
+
546
+ /**
547
+ * Extracts the root array path from an expression that ends with .map().
548
+ * Handles chained methods like .filter().map(), .slice().map(), etc.
195
549
  *
196
- * @param condition The condition expression to analyze
550
+ * Examples:
551
+ * - items.map(...) → "items"
552
+ * - data.users.map(...) → "data.users"
553
+ * - items.filter(...).map(...) → "items"
554
+ * - items.slice(0, 5).map(...) → "items"
555
+ */
556
+ function extractArrayPathFromMapCall(
557
+ expr: ts.CallExpression,
558
+ sourceFile: ts.SourceFile,
559
+ ): string | null {
560
+ // Walk up the chain to find the root array
561
+ let current: ts.Expression = expr.expression;
562
+
563
+ while (ts.isPropertyAccessExpression(current)) {
564
+ const methodName = current.name.getText(sourceFile);
565
+
566
+ // Common array methods that return arrays (so we keep going up)
567
+ const arrayReturningMethods = [
568
+ 'map',
569
+ 'filter',
570
+ 'slice',
571
+ 'concat',
572
+ 'flat',
573
+ 'flatMap',
574
+ 'reverse',
575
+ 'sort',
576
+ 'toReversed',
577
+ 'toSorted',
578
+ 'toSpliced',
579
+ ];
580
+
581
+ if (arrayReturningMethods.includes(methodName)) {
582
+ const objectExpr = current.expression;
583
+
584
+ // If the object is a call expression (chained method), keep going
585
+ if (ts.isCallExpression(objectExpr)) {
586
+ current = objectExpr.expression;
587
+ } else {
588
+ // Found the root - it's an identifier or property access
589
+ const path = StructuredPath.fromNode(objectExpr, sourceFile);
590
+ return path ? path.toString() : null;
591
+ }
592
+ } else {
593
+ // Not an array method we recognize
594
+ break;
595
+ }
596
+ }
597
+
598
+ return null;
599
+ }
600
+
601
+ /**
602
+ * Extracts JSX rendering usages from a JSX expression.
603
+ * Detects:
604
+ * - array.map() calls → 'array-map' type
605
+ * - string interpolations (identifiers/property access) → 'text-interpolation' type
606
+ *
607
+ * Recursively searches inside && chains and ternary expressions.
608
+ *
609
+ * @param expr The expression inside {expr}
197
610
  * @param context The analysis context
198
- * @param location Where this condition appears (if, ternary, logical-and, switch)
199
611
  */
200
- export function extractConditionalUsage(
201
- condition: ts.Expression,
612
+ function extractJsxRenderingUsage(
613
+ expr: ts.Expression,
202
614
  context: AnalysisContext,
203
- location: ConditionalUsage['location'],
204
615
  ): void {
205
- const unwrapped = unwrapExpression(condition);
616
+ const unwrapped = unwrapExpression(expr);
617
+ const sourceLocation = getSourceLocation(expr, context.sourceFile);
206
618
 
207
- // Handle binary expressions with && (logical AND chains)
208
- // Example: `a && b && <Component />` - both a and b are conditional checks
209
- if (
619
+ // Detect array.map() calls
620
+ if (ts.isCallExpression(unwrapped)) {
621
+ const calleeExpr = unwrapped.expression;
622
+
623
+ if (ts.isPropertyAccessExpression(calleeExpr)) {
624
+ const methodName = calleeExpr.name.getText(context.sourceFile);
625
+
626
+ if (methodName === 'map') {
627
+ const arrayPath = extractArrayPathFromMapCall(
628
+ unwrapped,
629
+ context.sourceFile,
630
+ );
631
+
632
+ if (arrayPath) {
633
+ context.addJsxRenderingUsage({
634
+ path: arrayPath,
635
+ renderingType: 'array-map',
636
+ valueType: 'array',
637
+ sourceLocation,
638
+ });
639
+ }
640
+ }
641
+ }
642
+ }
643
+ // Detect simple string interpolations: {title} or {user.name}
644
+ else if (
645
+ ts.isIdentifier(unwrapped) ||
646
+ ts.isPropertyAccessExpression(unwrapped)
647
+ ) {
648
+ const path = StructuredPath.fromNode(unwrapped, context.sourceFile);
649
+
650
+ if (path) {
651
+ const pathStr = path.toString();
652
+ const typeInfo = context.getTypeInfo(path);
653
+
654
+ // Only track as text interpolation if it's a string type
655
+ // Check for 'string' type, or types that contain 'string' (but not 'string[]')
656
+ if (
657
+ typeInfo === 'string' ||
658
+ (typeInfo &&
659
+ typeInfo.includes('string') &&
660
+ !typeInfo.includes('string[]'))
661
+ ) {
662
+ context.addJsxRenderingUsage({
663
+ path: pathStr,
664
+ renderingType: 'text-interpolation',
665
+ valueType: 'string',
666
+ sourceLocation,
667
+ });
668
+ }
669
+ }
670
+ }
671
+ // Recursively search inside && chains: {showList && items.map(...)}
672
+ else if (
210
673
  ts.isBinaryExpression(unwrapped) &&
211
674
  unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
212
675
  ) {
213
- // Recursively process left side
214
- extractConditionalUsage(unwrapped.left, context, location);
676
+ // Check the right side of the && chain (where .map() typically appears)
677
+ const rightSide = unwrapExpression(unwrapped.right);
678
+ extractJsxRenderingUsage(rightSide, context);
679
+ // Also check nested && chains on the left
680
+ extractJsxRenderingUsage(unwrapped.left, context);
681
+ }
682
+ // Recursively search inside ternaries: {isEmpty ? null : items.map(...)}
683
+ else if (ts.isConditionalExpression(unwrapped)) {
684
+ extractJsxRenderingUsage(unwrapped.whenTrue, context);
685
+ extractJsxRenderingUsage(unwrapped.whenFalse, context);
686
+ }
687
+ }
215
688
 
216
- // Process right side if it's not JSX (JSX is the consequence, not the condition)
689
+ /**
690
+ * Counts the number of conditions in an && chain (excluding JSX consequence)
691
+ */
692
+ function countConditionsInAndChain(expr: ts.Expression): number {
693
+ const unwrapped = unwrapExpression(expr);
694
+
695
+ if (
696
+ ts.isBinaryExpression(unwrapped) &&
697
+ unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
698
+ ) {
699
+ const leftCount = countConditionsInAndChain(unwrapped.left);
217
700
  const rightUnwrapped = unwrapExpression(unwrapped.right);
218
701
  const isJsxConsequence =
219
702
  ts.isJsxElement(rightUnwrapped) ||
220
703
  ts.isJsxSelfClosingElement(rightUnwrapped) ||
221
704
  ts.isJsxFragment(rightUnwrapped);
222
705
 
223
- if (!isJsxConsequence) {
224
- extractConditionalUsage(unwrapped.right, context, location);
706
+ if (isJsxConsequence) {
707
+ return leftCount;
225
708
  }
226
- return;
709
+ return leftCount + countConditionsInAndChain(unwrapped.right);
227
710
  }
228
711
 
229
- // Handle binary expressions with || (logical OR)
230
- if (
231
- ts.isBinaryExpression(unwrapped) &&
232
- unwrapped.operatorToken.kind === ts.SyntaxKind.BarBarToken
233
- ) {
234
- // Both sides of || are conditional checks
235
- extractConditionalUsage(unwrapped.left, context, location);
236
- extractConditionalUsage(unwrapped.right, context, location);
712
+ // Single condition (not an && chain)
713
+ return 1;
714
+ }
715
+
716
+ /**
717
+ * Chain tracking info for compound conditionals
718
+ */
719
+ interface ChainInfo {
720
+ chainId: string;
721
+ chainLength: number;
722
+ chainExpression: string;
723
+ currentPosition: number;
724
+ compound: CompoundConditional;
725
+ /**
726
+ * When processing OR expressions within an && chain, this tracks the
727
+ * current OR group ID. Conditions added while this is set will be marked
728
+ * as OR alternatives (only one needs to be true).
729
+ */
730
+ currentOrGroupId?: string;
731
+ }
732
+
733
+ /**
734
+ * Parent gating condition accumulated during JSX traversal.
735
+ * Used to track conditions from parent && chains that gate child components.
736
+ */
737
+ interface ParentGatingCondition {
738
+ path: string;
739
+ sourceLocation: { lineNumber: number; column: number; codeSnippet: string };
740
+ isNegated?: boolean;
741
+ }
742
+
743
+ /**
744
+ * Extracts conditionals from JSX elements by recursively traversing children.
745
+ *
746
+ * This is CRITICAL for extracting compound conditionals from JSX expressions
747
+ * like `{hasNewerVersion && !isActive && <Banner />}`.
748
+ *
749
+ * This function is called BEFORE the child boundary check in processExpression
750
+ * because JSX elements are NOT scopes - their expressions use variables from
751
+ * the parent scope and should have their conditionals extracted regardless of
752
+ * whether the JSX is within a child boundary.
753
+ *
754
+ * Fix 32: Added parentConditions parameter to track gating conditions from
755
+ * parent && chains. When we find a component nested inside multiple conditionals
756
+ * like `{activeTab && <>{ternary ? ... : <Component />}</>}`, ALL parent
757
+ * conditions should be added as gating conditions for the component.
758
+ *
759
+ * @param node The JSX element, self-closing element, or fragment to traverse
760
+ * @param context The analysis context
761
+ * @param parentConditions Accumulated gating conditions from parent && chains
762
+ */
763
+ function extractConditionalsFromJsx(
764
+ node: ts.JsxElement | ts.JsxSelfClosingElement | ts.JsxFragment,
765
+ context: AnalysisContext,
766
+ parentConditions: ParentGatingCondition[] = [],
767
+ ): void {
768
+ // Get children to process
769
+ let children: ts.NodeArray<ts.JsxChild> | undefined;
770
+
771
+ if (ts.isJsxElement(node)) {
772
+ children = node.children;
773
+ } else if (ts.isJsxFragment(node)) {
774
+ children = node.children;
775
+ }
776
+ // JsxSelfClosingElement has no children
777
+
778
+ if (!children) {
237
779
  return;
238
780
  }
239
781
 
240
- // Handle comparison operators (===, !==, <, >, <=, >=)
241
- // Example: `if (status === 'active')` - status is compared against 'active'
242
- if (
243
- ts.isBinaryExpression(unwrapped) &&
244
- isComparisonOperator(unwrapped.operatorToken.kind)
245
- ) {
246
- // Try to extract the variable and the compared value
247
- const leftPath = StructuredPath.fromNode(
248
- unwrapped.left,
249
- context.sourceFile,
250
- );
251
- const rightPath = StructuredPath.fromNode(
252
- unwrapped.right,
253
- context.sourceFile,
254
- );
782
+ for (const child of children) {
783
+ // Process JSX expressions: {expr}
784
+ if (ts.isJsxExpression(child) && child.expression) {
785
+ const expr = unwrapExpression(child.expression);
255
786
 
256
- // Check if left is a variable and right is a literal
257
- if (leftPath && isLiteralExpression(unwrapped.right)) {
258
- const literalValue = getLiteralValue(unwrapped.right, context);
259
- context.addConditionalUsage({
260
- path: leftPath.toLeftHandSideString(),
261
- conditionType: 'comparison',
262
- comparedValues: literalValue !== undefined ? [literalValue] : undefined,
263
- location,
264
- });
787
+ // Extract JSX rendering usages (array.map, text interpolation)
788
+ // This handles direct usages like {items.map(...)} or {user.name}
789
+ extractJsxRenderingUsage(expr, context);
790
+
791
+ // If the expression is an && chain, extract its conditional usages
792
+ if (
793
+ ts.isBinaryExpression(expr) &&
794
+ expr.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
795
+ ) {
796
+ // Mark nullable variables
797
+ markConditionVariablesAsNullable(expr, context);
798
+ // Extract conditional usage (this handles compound conditionals)
799
+ // Pass controlsJsxRendering: true since this conditional controls JSX rendering
800
+ extractConditionalUsage(expr, context, 'logical-and', {
801
+ controlsJsxRendering: true,
802
+ });
803
+
804
+ // Extract all condition paths from the && chain for gating tracking
805
+ const conditionPaths = extractConditionPathsFromAndChain(
806
+ expr,
807
+ context.sourceFile,
808
+ );
809
+ const sourceLocation = getSourceLocation(expr, context.sourceFile);
810
+
811
+ // Fix 32: Build accumulated conditions including parent conditions
812
+ const accumulatedConditions: ParentGatingCondition[] = [
813
+ ...parentConditions,
814
+ ...conditionPaths.map((path) => ({
815
+ path,
816
+ sourceLocation,
817
+ isNegated: false,
818
+ })),
819
+ ];
820
+
821
+ // Track gating conditions for child components
822
+ // Example: {hasAnalysis && <ScenarioViewer />}
823
+ const jsxElement = findJsxInAndChain(expr);
824
+ if (jsxElement) {
825
+ const componentName = getComponentNameFromJsx(jsxElement);
826
+ if (componentName) {
827
+ // Fix 32: Add ALL accumulated conditions (parent + current) as gating conditions
828
+ for (const condition of accumulatedConditions) {
829
+ context.addChildBoundaryGatingCondition(componentName, {
830
+ path: condition.path,
831
+ conditionType: 'truthiness',
832
+ location: 'logical-and',
833
+ sourceLocation: condition.sourceLocation,
834
+ controlsJsxRendering: true,
835
+ isNegated: condition.isNegated,
836
+ });
837
+ }
838
+ }
839
+
840
+ // Fix 32: Recursively process nested JSX with accumulated conditions
841
+ if (
842
+ ts.isJsxElement(jsxElement) ||
843
+ ts.isJsxSelfClosingElement(jsxElement)
844
+ ) {
845
+ extractConditionalsFromJsx(
846
+ jsxElement,
847
+ context,
848
+ accumulatedConditions,
849
+ );
850
+ }
851
+ }
852
+
853
+ // Fix 32: Also check for nested JSX fragments
854
+ const jsxFragment = findJsxFragmentInAndChain(expr);
855
+ if (jsxFragment) {
856
+ extractConditionalsFromJsx(
857
+ jsxFragment,
858
+ context,
859
+ accumulatedConditions,
860
+ );
861
+ }
862
+ }
863
+ // If the expression is a ternary, extract its conditional
864
+ else if (ts.isConditionalExpression(expr)) {
865
+ // Pass controlsJsxRendering: true since this conditional controls JSX rendering
866
+ extractConditionalUsage(expr.condition, context, 'ternary', {
867
+ controlsJsxRendering: true,
868
+ });
869
+
870
+ // Track gating conditions for components in both branches of the ternary
871
+ // Example: {isError ? <ErrorView /> : <SuccessView />}
872
+ const conditionPath = StructuredPath.fromNode(
873
+ unwrapExpression(expr.condition),
874
+ context.sourceFile,
875
+ );
876
+ const sourceLocation = getSourceLocation(expr, context.sourceFile);
877
+
878
+ // Recursively process the whenTrue and whenFalse branches for JSX
879
+ const whenTrue = unwrapExpression(expr.whenTrue);
880
+ const whenFalse = unwrapExpression(expr.whenFalse);
881
+
882
+ // Fix 32: Build conditions for whenTrue branch (parent conditions + ternary condition truthy)
883
+ const whenTrueConditions: ParentGatingCondition[] = [
884
+ ...parentConditions,
885
+ ...(conditionPath
886
+ ? [
887
+ {
888
+ path: conditionPath.toString(),
889
+ sourceLocation,
890
+ isNegated: false,
891
+ },
892
+ ]
893
+ : []),
894
+ ];
895
+
896
+ // Fix 32: Build conditions for whenFalse branch (parent conditions + ternary condition falsy)
897
+ const whenFalseConditions: ParentGatingCondition[] = [
898
+ ...parentConditions,
899
+ ...(conditionPath
900
+ ? [
901
+ {
902
+ path: conditionPath.toString(),
903
+ sourceLocation,
904
+ isNegated: true,
905
+ },
906
+ ]
907
+ : []),
908
+ ];
909
+
910
+ // Handle whenTrue branch (condition is truthy)
911
+ if (ts.isJsxElement(whenTrue) || ts.isJsxSelfClosingElement(whenTrue)) {
912
+ const componentName = getComponentNameFromJsx(whenTrue);
913
+ if (componentName) {
914
+ // Fix 32: Add ALL conditions (parent + ternary) as gating conditions
915
+ for (const condition of whenTrueConditions) {
916
+ context.addChildBoundaryGatingCondition(componentName, {
917
+ path: condition.path,
918
+ conditionType: 'truthiness',
919
+ location: 'ternary',
920
+ sourceLocation: condition.sourceLocation,
921
+ controlsJsxRendering: true,
922
+ isNegated: condition.isNegated,
923
+ });
924
+ }
925
+ }
926
+ }
927
+ if (
928
+ ts.isJsxElement(whenTrue) ||
929
+ ts.isJsxSelfClosingElement(whenTrue) ||
930
+ ts.isJsxFragment(whenTrue)
931
+ ) {
932
+ extractConditionalsFromJsx(whenTrue, context, whenTrueConditions);
933
+ }
934
+
935
+ // Handle whenFalse branch (condition is falsy/negated)
936
+ if (
937
+ ts.isJsxElement(whenFalse) ||
938
+ ts.isJsxSelfClosingElement(whenFalse)
939
+ ) {
940
+ const componentName = getComponentNameFromJsx(whenFalse);
941
+ if (componentName) {
942
+ // Fix 32: Add ALL conditions (parent + ternary) as gating conditions
943
+ for (const condition of whenFalseConditions) {
944
+ context.addChildBoundaryGatingCondition(componentName, {
945
+ path: condition.path,
946
+ conditionType: 'truthiness',
947
+ location: 'ternary',
948
+ sourceLocation: condition.sourceLocation,
949
+ controlsJsxRendering: true,
950
+ isNegated: condition.isNegated,
951
+ });
952
+ }
953
+ }
954
+ }
955
+ if (
956
+ ts.isJsxElement(whenFalse) ||
957
+ ts.isJsxSelfClosingElement(whenFalse) ||
958
+ ts.isJsxFragment(whenFalse)
959
+ ) {
960
+ extractConditionalsFromJsx(whenFalse, context, whenFalseConditions);
961
+ }
962
+ // Handle chained ternaries: a ? <A/> : b ? <B/> : <C/>
963
+ // When whenFalse is another ConditionalExpression, recursively process it
964
+ else if (ts.isConditionalExpression(whenFalse)) {
965
+ // Extract conditional usage for the nested ternary's condition
966
+ extractConditionalUsage(whenFalse.condition, context, 'ternary', {
967
+ controlsJsxRendering: true,
968
+ });
969
+
970
+ // Get the nested condition path
971
+ const nestedConditionPath = StructuredPath.fromNode(
972
+ unwrapExpression(whenFalse.condition),
973
+ context.sourceFile,
974
+ );
975
+ const nestedSourceLocation = getSourceLocation(
976
+ whenFalse,
977
+ context.sourceFile,
978
+ );
979
+
980
+ const nestedWhenTrue = unwrapExpression(whenFalse.whenTrue);
981
+ const nestedWhenFalse = unwrapExpression(whenFalse.whenFalse);
982
+
983
+ // Fix 32: Build conditions for nested whenTrue (parent falsy + nested truthy)
984
+ const nestedWhenTrueConditions: ParentGatingCondition[] = [
985
+ ...whenFalseConditions, // Parent ternary was falsy to get here
986
+ ...(nestedConditionPath
987
+ ? [
988
+ {
989
+ path: nestedConditionPath.toString(),
990
+ sourceLocation: nestedSourceLocation,
991
+ isNegated: false,
992
+ },
993
+ ]
994
+ : []),
995
+ ];
996
+
997
+ // Fix 32: Build conditions for nested whenFalse (parent falsy + nested falsy)
998
+ const nestedWhenFalseConditions: ParentGatingCondition[] = [
999
+ ...whenFalseConditions, // Parent ternary was falsy to get here
1000
+ ...(nestedConditionPath
1001
+ ? [
1002
+ {
1003
+ path: nestedConditionPath.toString(),
1004
+ sourceLocation: nestedSourceLocation,
1005
+ isNegated: true,
1006
+ },
1007
+ ]
1008
+ : []),
1009
+ ];
1010
+
1011
+ // Handle nested whenTrue branch
1012
+ if (
1013
+ ts.isJsxElement(nestedWhenTrue) ||
1014
+ ts.isJsxSelfClosingElement(nestedWhenTrue)
1015
+ ) {
1016
+ const componentName = getComponentNameFromJsx(nestedWhenTrue);
1017
+ if (componentName) {
1018
+ // Fix 32: Add ALL accumulated conditions
1019
+ for (const condition of nestedWhenTrueConditions) {
1020
+ context.addChildBoundaryGatingCondition(componentName, {
1021
+ path: condition.path,
1022
+ conditionType: 'truthiness',
1023
+ location: 'ternary',
1024
+ sourceLocation: condition.sourceLocation,
1025
+ controlsJsxRendering: true,
1026
+ isNegated: condition.isNegated,
1027
+ });
1028
+ }
1029
+ }
1030
+ }
1031
+ if (
1032
+ ts.isJsxElement(nestedWhenTrue) ||
1033
+ ts.isJsxSelfClosingElement(nestedWhenTrue) ||
1034
+ ts.isJsxFragment(nestedWhenTrue)
1035
+ ) {
1036
+ extractConditionalsFromJsx(
1037
+ nestedWhenTrue,
1038
+ context,
1039
+ nestedWhenTrueConditions,
1040
+ );
1041
+ }
1042
+
1043
+ // Handle nested whenFalse branch (this could be another chained ternary or JSX)
1044
+ if (
1045
+ ts.isJsxElement(nestedWhenFalse) ||
1046
+ ts.isJsxSelfClosingElement(nestedWhenFalse)
1047
+ ) {
1048
+ const componentName = getComponentNameFromJsx(nestedWhenFalse);
1049
+ if (componentName) {
1050
+ // Fix 32: Add ALL accumulated conditions
1051
+ for (const condition of nestedWhenFalseConditions) {
1052
+ context.addChildBoundaryGatingCondition(componentName, {
1053
+ path: condition.path,
1054
+ conditionType: 'truthiness',
1055
+ location: 'ternary',
1056
+ sourceLocation: condition.sourceLocation,
1057
+ controlsJsxRendering: true,
1058
+ isNegated: condition.isNegated,
1059
+ });
1060
+ }
1061
+ }
1062
+ }
1063
+ if (
1064
+ ts.isJsxElement(nestedWhenFalse) ||
1065
+ ts.isJsxSelfClosingElement(nestedWhenFalse) ||
1066
+ ts.isJsxFragment(nestedWhenFalse)
1067
+ ) {
1068
+ extractConditionalsFromJsx(
1069
+ nestedWhenFalse,
1070
+ context,
1071
+ nestedWhenFalseConditions,
1072
+ );
1073
+ }
1074
+ // If nestedWhenFalse is yet another ConditionalExpression, the recursion
1075
+ // will handle it on the next iteration when this function processes it
1076
+ else if (ts.isConditionalExpression(nestedWhenFalse)) {
1077
+ // Recursively handle deeper nesting by wrapping in a synthetic process
1078
+ // We create a fake JsxExpression context to reuse the same logic
1079
+ const syntheticChild = {
1080
+ kind: ts.SyntaxKind.JsxExpression,
1081
+ expression: nestedWhenFalse,
1082
+ } as unknown as ts.JsxExpression;
1083
+ // Process via the main JSX expression handler by recursing
1084
+ // For now, just extract conditionals directly
1085
+ extractConditionalUsage(
1086
+ nestedWhenFalse.condition,
1087
+ context,
1088
+ 'ternary',
1089
+ { controlsJsxRendering: true },
1090
+ );
1091
+ }
1092
+ }
1093
+ }
1094
+ }
1095
+ // Recursively process nested JSX elements - Fix 32: pass parent conditions
1096
+ else if (ts.isJsxElement(child)) {
1097
+ // Check if this is a user-defined component (vs intrinsic element like div)
1098
+ const componentName = getComponentNameFromJsx(child);
1099
+ if (componentName) {
1100
+ if (parentConditions.length > 0) {
1101
+ // If there are parent conditions, record them as gating conditions
1102
+ console.log(
1103
+ `[ChildBoundary] ${componentName}: Conditionally rendered with ${parentConditions.length} gating conditions`,
1104
+ );
1105
+ for (const condition of parentConditions) {
1106
+ console.log(
1107
+ `[ChildBoundary] ${componentName}: Adding gating condition path='${condition.path}' isNegated=${condition.isNegated}`,
1108
+ );
1109
+ context.addChildBoundaryGatingCondition(componentName, {
1110
+ path: condition.path,
1111
+ conditionType: 'truthiness',
1112
+ location: 'ternary',
1113
+ sourceLocation: condition.sourceLocation,
1114
+ controlsJsxRendering: true,
1115
+ isNegated: condition.isNegated,
1116
+ });
1117
+ }
1118
+ } else {
1119
+ // No parent conditions - check if it has data props for unconditional tracking
1120
+ console.log(
1121
+ `[ChildBoundary] ${componentName}: Checking for unconditional rendering with data props...`,
1122
+ );
1123
+ const { hasDataProps, dataProps } = hasDataPropsFromParent(
1124
+ child,
1125
+ componentName,
1126
+ );
1127
+ if (hasDataProps) {
1128
+ // Fix: Track unconditionally-rendered children that receive data props
1129
+ // These need to be tracked for flow merging even without gating conditions
1130
+ // Example: <WorkoutsView workouts={workouts} /> - parent controls workouts data
1131
+ console.log(
1132
+ `[ChildBoundary] ${componentName}: TRACKING as unconditionally-rendered with data props: [${dataProps.join(', ')}]`,
1133
+ );
1134
+ context.addChildBoundaryGatingCondition(componentName, {
1135
+ path: '__unconditional__',
1136
+ conditionType: 'truthiness',
1137
+ location: 'unconditional',
1138
+ controlsJsxRendering: true,
1139
+ isNegated: false,
1140
+ });
1141
+ }
1142
+ }
1143
+ }
1144
+ extractConditionalsFromJsx(child, context, parentConditions);
1145
+ }
1146
+ // Handle self-closing JSX elements (e.g., <ScenarioViewer />)
1147
+ else if (ts.isJsxSelfClosingElement(child)) {
1148
+ // Check if this is a user-defined component (vs intrinsic element like div)
1149
+ const componentName = getComponentNameFromJsx(child);
1150
+ if (componentName) {
1151
+ if (parentConditions.length > 0) {
1152
+ // If there are parent conditions, record them as gating conditions
1153
+ console.log(
1154
+ `[ChildBoundary] ${componentName}: Conditionally rendered (self-closing) with ${parentConditions.length} gating conditions`,
1155
+ );
1156
+ for (const condition of parentConditions) {
1157
+ console.log(
1158
+ `[ChildBoundary] ${componentName}: Adding gating condition path='${condition.path}' isNegated=${condition.isNegated}`,
1159
+ );
1160
+ context.addChildBoundaryGatingCondition(componentName, {
1161
+ path: condition.path,
1162
+ conditionType: 'truthiness',
1163
+ location: 'ternary',
1164
+ sourceLocation: condition.sourceLocation,
1165
+ controlsJsxRendering: true,
1166
+ isNegated: condition.isNegated,
1167
+ });
1168
+ }
1169
+ } else {
1170
+ // No parent conditions - check if it has data props for unconditional tracking
1171
+ console.log(
1172
+ `[ChildBoundary] ${componentName}: Checking for unconditional rendering (self-closing) with data props...`,
1173
+ );
1174
+ const { hasDataProps, dataProps } = hasDataPropsFromParent(
1175
+ child,
1176
+ componentName,
1177
+ );
1178
+ if (hasDataProps) {
1179
+ // Fix: Track unconditionally-rendered children that receive data props
1180
+ console.log(
1181
+ `[ChildBoundary] ${componentName}: TRACKING as unconditionally-rendered (self-closing) with data props: [${dataProps.join(', ')}]`,
1182
+ );
1183
+ context.addChildBoundaryGatingCondition(componentName, {
1184
+ path: '__unconditional__',
1185
+ conditionType: 'truthiness',
1186
+ location: 'unconditional',
1187
+ controlsJsxRendering: true,
1188
+ isNegated: false,
1189
+ });
1190
+ }
1191
+ }
1192
+ }
1193
+ // Self-closing elements have no children, so no recursion needed
1194
+ }
1195
+ // Recursively process nested JSX fragments - Fix 32: pass parent conditions
1196
+ else if (ts.isJsxFragment(child)) {
1197
+ extractConditionalsFromJsx(child, context, parentConditions);
1198
+ }
1199
+ }
1200
+ }
1201
+
1202
+ /**
1203
+ * Options for extractConditionalUsage
1204
+ */
1205
+ interface ExtractConditionalOptions {
1206
+ /**
1207
+ * Whether this conditional controls JSX rendering.
1208
+ * Set to true when the conditional appears in a JSX expression like {cond && <Component />}
1209
+ */
1210
+ controlsJsxRendering?: boolean;
1211
+ }
1212
+
1213
+ /**
1214
+ * Extracts conditional usages from a condition expression for key attribute detection.
1215
+ * This function identifies which attributes are used in conditionals and how they're used.
1216
+ * It also tracks compound conditionals (&&-chains) where all conditions must be true together.
1217
+ *
1218
+ * @param condition The condition expression to analyze
1219
+ * @param context The analysis context
1220
+ * @param location Where this condition appears (if, ternary, logical-and, switch)
1221
+ * @param options Additional options including controlsJsxRendering flag
1222
+ */
1223
+ export function extractConditionalUsage(
1224
+ condition: ts.Expression,
1225
+ context: AnalysisContext,
1226
+ location: ConditionalUsage['location'],
1227
+ options: ExtractConditionalOptions = {},
1228
+ ): void {
1229
+ const { controlsJsxRendering } = options;
1230
+ // Internal recursive function with chain tracking
1231
+ function extractWithChainTracking(
1232
+ expr: ts.Expression,
1233
+ chainInfo: ChainInfo | null,
1234
+ isNegated: boolean,
1235
+ ): void {
1236
+ const unwrapped = unwrapExpression(expr);
1237
+
1238
+ // Handle binary expressions with && (logical AND chains)
1239
+ // Example: `a && b && <Component />` - both a and b are conditional checks
1240
+ if (
1241
+ ts.isBinaryExpression(unwrapped) &&
1242
+ unwrapped.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken
1243
+ ) {
1244
+ // Track if we're creating the chain at this level (root of the chain)
1245
+ const isChainRoot = !chainInfo;
1246
+
1247
+ // If no chainInfo, this is the root of a new chain
1248
+ if (isChainRoot) {
1249
+ const chainLength = countConditionsInAndChain(unwrapped);
1250
+ // Only create chain tracking for chains with 2+ conditions
1251
+ if (chainLength >= 2) {
1252
+ const chainId = `chain_${crypto.randomUUID().slice(0, 8)}`;
1253
+ const chainExpression = unwrapped.getText(context.sourceFile);
1254
+ const compound: CompoundConditional = {
1255
+ chainId,
1256
+ expression:
1257
+ chainExpression.length > 200
1258
+ ? chainExpression.slice(0, 200) + '...'
1259
+ : chainExpression,
1260
+ conditions: [],
1261
+ location,
1262
+ sourceLocation: getSourceLocation(unwrapped, context.sourceFile),
1263
+ controlsJsxRendering,
1264
+ };
1265
+ chainInfo = {
1266
+ chainId,
1267
+ chainLength,
1268
+ chainExpression: compound.expression,
1269
+ currentPosition: 0,
1270
+ compound,
1271
+ };
1272
+ }
1273
+ }
1274
+
1275
+ // Recursively process left side
1276
+ extractWithChainTracking(unwrapped.left, chainInfo, false);
1277
+
1278
+ // Process right side if it's not JSX (JSX is the consequence, not the condition)
1279
+ const rightUnwrapped = unwrapExpression(unwrapped.right);
1280
+ const isJsxConsequence =
1281
+ ts.isJsxElement(rightUnwrapped) ||
1282
+ ts.isJsxSelfClosingElement(rightUnwrapped) ||
1283
+ ts.isJsxFragment(rightUnwrapped);
1284
+
1285
+ if (!isJsxConsequence) {
1286
+ extractWithChainTracking(unwrapped.right, chainInfo, false);
1287
+ }
1288
+
1289
+ // If this is the root of the chain, register the compound conditional
1290
+ if (isChainRoot && chainInfo) {
1291
+ context.addCompoundConditional(chainInfo.compound);
1292
+ }
265
1293
  return;
266
1294
  }
267
1295
 
268
- // Check if right is a variable and left is a literal
269
- if (rightPath && isLiteralExpression(unwrapped.left)) {
270
- const literalValue = getLiteralValue(unwrapped.left, context);
271
- context.addConditionalUsage({
272
- path: rightPath.toLeftHandSideString(),
273
- conditionType: 'comparison',
274
- comparedValues: literalValue !== undefined ? [literalValue] : undefined,
275
- location,
276
- });
1296
+ // Handle binary expressions with || (logical OR)
1297
+ // When OR is inside an && chain, we need to continue chain tracking
1298
+ // and mark conditions as OR alternatives
1299
+ if (
1300
+ ts.isBinaryExpression(unwrapped) &&
1301
+ unwrapped.operatorToken.kind === ts.SyntaxKind.BarBarToken
1302
+ ) {
1303
+ if (chainInfo) {
1304
+ // We're inside an && chain - continue tracking but mark as OR alternatives
1305
+ // Generate an orGroupId so conditions from both sides can be grouped
1306
+ const orGroupId =
1307
+ chainInfo.currentOrGroupId ?? `or_${crypto.randomUUID().slice(0, 8)}`;
1308
+
1309
+ // Process left side with OR group tracking
1310
+ const leftChainInfo = {
1311
+ ...chainInfo,
1312
+ currentOrGroupId: orGroupId,
1313
+ };
1314
+ extractWithChainTracking(unwrapped.left, leftChainInfo, false);
1315
+
1316
+ // Process right side with same OR group
1317
+ // Note: we use leftChainInfo's currentPosition which may have been updated
1318
+ const rightChainInfo = {
1319
+ ...leftChainInfo,
1320
+ currentPosition: chainInfo.currentPosition,
1321
+ };
1322
+ extractWithChainTracking(unwrapped.right, rightChainInfo, false);
1323
+ } else {
1324
+ // Not inside a chain - OR breaks into independent conditional checks
1325
+ extractWithChainTracking(unwrapped.left, null, false);
1326
+ extractWithChainTracking(unwrapped.right, null, false);
1327
+ }
277
1328
  return;
278
1329
  }
279
1330
 
280
- // Both sides are variables - record both as comparisons without specific values
281
- if (leftPath) {
282
- context.addConditionalUsage({
283
- path: leftPath.toLeftHandSideString(),
284
- conditionType: 'comparison',
285
- location,
286
- });
1331
+ // Handle comparison operators (===, !==, <, >, <=, >=)
1332
+ // Example: `if (status === 'active')` - status is compared against 'active'
1333
+ if (
1334
+ ts.isBinaryExpression(unwrapped) &&
1335
+ isComparisonOperator(unwrapped.operatorToken.kind)
1336
+ ) {
1337
+ // Try to extract the variable and the compared value
1338
+ const leftPath = StructuredPath.fromNode(
1339
+ unwrapped.left,
1340
+ context.sourceFile,
1341
+ );
1342
+ const rightPath = StructuredPath.fromNode(
1343
+ unwrapped.right,
1344
+ context.sourceFile,
1345
+ );
1346
+
1347
+ // Determine the compared value for computing requiredValue
1348
+ const getRequiredValue = (
1349
+ literalValue: string | undefined,
1350
+ isNegatedComparison: boolean,
1351
+ ): string | boolean | undefined => {
1352
+ if (literalValue === undefined) return undefined;
1353
+ // For !== comparisons, the condition is true when NOT equal to the value
1354
+ // For === comparisons, the condition is true when equal to the value
1355
+ const isNotEqual =
1356
+ unwrapped.operatorToken.kind ===
1357
+ ts.SyntaxKind.ExclamationEqualsEqualsToken ||
1358
+ unwrapped.operatorToken.kind === ts.SyntaxKind.ExclamationEqualsToken;
1359
+ if (isNotEqual) {
1360
+ // !== 'value' means requiredValue is NOT 'value', but we express this as "not 'value'"
1361
+ return `not ${literalValue}`;
1362
+ }
1363
+ return literalValue;
1364
+ };
1365
+
1366
+ // Get the comparison operator string for the compound condition
1367
+ const comparisonOperator = getComparisonOperatorString(
1368
+ unwrapped.operatorToken.kind,
1369
+ );
1370
+
1371
+ // Helper to add a condition
1372
+ const addCondition = (
1373
+ path: string,
1374
+ conditionType: 'comparison' | 'truthiness',
1375
+ comparedValues?: string[],
1376
+ requiredValue?: string | boolean,
1377
+ sourceExpr?: ts.Expression,
1378
+ ) => {
1379
+ const usage: ConditionalUsage = {
1380
+ path,
1381
+ conditionType,
1382
+ comparedValues,
1383
+ location,
1384
+ sourceLocation: getSourceLocation(unwrapped, context.sourceFile),
1385
+ isNegated,
1386
+ controlsJsxRendering,
1387
+ };
1388
+
1389
+ // Check for inline array-derived patterns (.length) on the source expression
1390
+ if (sourceExpr) {
1391
+ const arrayDerived = detectArrayDerivedPattern(sourceExpr);
1392
+ if (arrayDerived) {
1393
+ usage.derivedFrom = {
1394
+ operation: arrayDerived.operation,
1395
+ sourcePath: arrayDerived.sourcePath,
1396
+ };
1397
+ }
1398
+ }
1399
+
1400
+ // Add chain info if part of a compound conditional
1401
+ if (chainInfo) {
1402
+ usage.chainId = chainInfo.chainId;
1403
+ usage.chainPosition = chainInfo.currentPosition;
1404
+ usage.chainLength = chainInfo.chainLength;
1405
+ usage.chainExpression = chainInfo.chainExpression;
1406
+ chainInfo.currentPosition++;
1407
+
1408
+ // Add to compound conditional conditions
1409
+ chainInfo.compound.conditions.push({
1410
+ path,
1411
+ conditionType,
1412
+ comparedValues,
1413
+ isNegated,
1414
+ requiredValue,
1415
+ ...(comparisonOperator && { comparisonOperator }),
1416
+ ...(chainInfo.currentOrGroupId && {
1417
+ orGroupId: chainInfo.currentOrGroupId,
1418
+ }),
1419
+ });
1420
+ }
1421
+
1422
+ context.addConditionalUsage(usage);
1423
+ };
1424
+
1425
+ // Check if left is a variable and right is a literal
1426
+ if (leftPath && isLiteralExpression(unwrapped.right)) {
1427
+ const literalValue = getLiteralValue(unwrapped.right, context);
1428
+ addCondition(
1429
+ leftPath.toLeftHandSideString(),
1430
+ 'comparison',
1431
+ literalValue !== undefined ? [literalValue] : undefined,
1432
+ getRequiredValue(literalValue, isNegated),
1433
+ unwrapped.left, // Pass source expression for array derivation detection
1434
+ );
1435
+ return;
1436
+ }
1437
+
1438
+ // Check if right is a variable and left is a literal
1439
+ if (rightPath && isLiteralExpression(unwrapped.left)) {
1440
+ const literalValue = getLiteralValue(unwrapped.left, context);
1441
+ addCondition(
1442
+ rightPath.toLeftHandSideString(),
1443
+ 'comparison',
1444
+ literalValue !== undefined ? [literalValue] : undefined,
1445
+ getRequiredValue(literalValue, isNegated),
1446
+ unwrapped.right, // Pass source expression for array derivation detection
1447
+ );
1448
+ return;
1449
+ }
1450
+
1451
+ // Both sides are variables - record both as comparisons without specific values
1452
+ if (leftPath) {
1453
+ addCondition(
1454
+ leftPath.toLeftHandSideString(),
1455
+ 'comparison',
1456
+ undefined,
1457
+ undefined,
1458
+ unwrapped.left,
1459
+ );
1460
+ }
1461
+ if (rightPath) {
1462
+ addCondition(
1463
+ rightPath.toLeftHandSideString(),
1464
+ 'comparison',
1465
+ undefined,
1466
+ undefined,
1467
+ unwrapped.right,
1468
+ );
1469
+ }
1470
+ return;
287
1471
  }
288
- if (rightPath) {
289
- context.addConditionalUsage({
290
- path: rightPath.toLeftHandSideString(),
291
- conditionType: 'comparison',
292
- location,
293
- });
1472
+
1473
+ // Handle prefix unary NOT expression: !variable
1474
+ // Example: `if (!isVisible)` - isVisible is a truthiness check (negated)
1475
+ if (
1476
+ ts.isPrefixUnaryExpression(unwrapped) &&
1477
+ unwrapped.operator === ts.SyntaxKind.ExclamationToken
1478
+ ) {
1479
+ extractWithChainTracking(unwrapped.operand, chainInfo, !isNegated);
1480
+ return;
294
1481
  }
295
- return;
296
- }
297
1482
 
298
- // Handle prefix unary NOT expression: !variable
299
- // Example: `if (!isVisible)` - isVisible is a truthiness check
300
- if (
301
- ts.isPrefixUnaryExpression(unwrapped) &&
302
- unwrapped.operator === ts.SyntaxKind.ExclamationToken
303
- ) {
304
- extractConditionalUsage(unwrapped.operand, context, location);
305
- return;
306
- }
1483
+ // Handle simple identifiers or property accesses (truthiness checks)
1484
+ // Example: `if (x)` or `x && <JSX />` - x is checked for truthiness
1485
+ const path = StructuredPath.fromNode(unwrapped, context.sourceFile);
1486
+ if (path && !path.isLiteral()) {
1487
+ const pathStr = path.toLeftHandSideString();
1488
+ const usage: ConditionalUsage = {
1489
+ path: pathStr,
1490
+ conditionType: 'truthiness',
1491
+ location,
1492
+ sourceLocation: getSourceLocation(unwrapped, context.sourceFile),
1493
+ isNegated,
1494
+ controlsJsxRendering,
1495
+ };
1496
+
1497
+ // Check for inline array-derived patterns (.some(), .every(), .includes(), .length)
1498
+ // This populates derivedFrom so downstream code can resolve to the base array path
1499
+ const arrayDerived = detectArrayDerivedPattern(unwrapped);
1500
+ if (arrayDerived) {
1501
+ usage.derivedFrom = {
1502
+ operation: arrayDerived.operation,
1503
+ sourcePath: arrayDerived.sourcePath,
1504
+ };
1505
+ }
307
1506
 
308
- // Handle simple identifiers or property accesses (truthiness checks)
309
- // Example: `if (x)` or `x && <JSX />` - x is checked for truthiness
310
- const path = StructuredPath.fromNode(unwrapped, context.sourceFile);
311
- if (path && !path.isLiteral()) {
312
- context.addConditionalUsage({
313
- path: path.toLeftHandSideString(),
314
- conditionType: 'truthiness',
315
- location,
316
- });
1507
+ // Add chain info if part of a compound conditional
1508
+ if (chainInfo) {
1509
+ usage.chainId = chainInfo.chainId;
1510
+ usage.chainPosition = chainInfo.currentPosition;
1511
+ usage.chainLength = chainInfo.chainLength;
1512
+ usage.chainExpression = chainInfo.chainExpression;
1513
+ chainInfo.currentPosition++;
1514
+
1515
+ // Add to compound conditional conditions
1516
+ // For truthiness, requiredValue is true if not negated, false if negated
1517
+ chainInfo.compound.conditions.push({
1518
+ path: pathStr,
1519
+ conditionType: 'truthiness',
1520
+ isNegated,
1521
+ requiredValue: !isNegated,
1522
+ ...(chainInfo.currentOrGroupId && {
1523
+ orGroupId: chainInfo.currentOrGroupId,
1524
+ }),
1525
+ });
1526
+ }
1527
+
1528
+ context.addConditionalUsage(usage);
1529
+ }
317
1530
  }
1531
+
1532
+ // Start extraction with no chain info
1533
+ extractWithChainTracking(condition, null, false);
318
1534
  }
319
1535
 
320
1536
  /**
@@ -417,7 +1633,28 @@ export function processExpression({
417
1633
  ) {
418
1634
  markConditionVariablesAsNullable(unwrappedNode, context);
419
1635
  // Extract conditional usages for key attribute detection
420
- extractConditionalUsage(unwrappedNode, context, 'logical-and');
1636
+ // Only call from the OUTERMOST && expression to avoid duplicates
1637
+ // Check if parent is also a && (meaning we're nested)
1638
+ const parent = unwrappedNode.parent;
1639
+ const parentIsAndChain =
1640
+ parent &&
1641
+ ts.isBinaryExpression(parent) &&
1642
+ parent.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken;
1643
+ if (!parentIsAndChain) {
1644
+ extractConditionalUsage(unwrappedNode, context, 'logical-and');
1645
+ }
1646
+ }
1647
+
1648
+ // CRITICAL: Extract conditionals from JSX BEFORE checking child boundaries
1649
+ // JSX elements are NOT scopes - their expressions use variables from the parent scope.
1650
+ // Even if the JSX element is within a child boundary (e.g., because it contains callbacks),
1651
+ // we must still extract conditionals from JSX expression children like {x && <div>...</div>}
1652
+ if (
1653
+ ts.isJsxElement(unwrappedNode) ||
1654
+ ts.isJsxSelfClosingElement(unwrappedNode) ||
1655
+ ts.isJsxFragment(unwrappedNode)
1656
+ ) {
1657
+ extractConditionalsFromJsx(unwrappedNode, context);
421
1658
  }
422
1659
 
423
1660
  // If the node falls within an excluded child scope, stop processing it.
@@ -454,7 +1691,7 @@ export function processExpression({
454
1691
  const structure = context.getStructure();
455
1692
 
456
1693
  // Propagate existing equivalencies for sub-properties
457
- for (const [key, value] of Object.entries(equivalentVariables)) {
1694
+ for (const [key, rawValue] of Object.entries(equivalentVariables)) {
458
1695
  // Check if this equivalency is for a sub-property of the identifier
459
1696
  // e.g., completeDataStructure['Function Arguments'] or completeDataStructure.foo
460
1697
  if (
@@ -465,8 +1702,14 @@ export function processExpression({
465
1702
  const newTargetPath = StructuredPath.fromBase(
466
1703
  targetPath.toString() + subPath,
467
1704
  );
468
- const valuePath = StructuredPath.fromBase(value);
469
- context.addEquivalence(newTargetPath, valuePath);
1705
+ // Handle both string and string[] values
1706
+ const values = Array.isArray(rawValue) ? rawValue : [rawValue];
1707
+ for (const value of values) {
1708
+ if (typeof value === 'string') {
1709
+ const valuePath = StructuredPath.fromBase(value);
1710
+ context.addEquivalence(newTargetPath, valuePath);
1711
+ }
1712
+ }
470
1713
  }
471
1714
  }
472
1715
 
@@ -611,7 +1854,8 @@ export function processExpression({
611
1854
  // Check if this is an environment variable access
612
1855
  const fullText = unwrappedNode.getText(context.sourceFile);
613
1856
  if (
614
- fullText.includes('.env.') // simple heuristic for env var access but not great
1857
+ fullText.includes('.env.') || // process.env.X, window.env.X
1858
+ isEnvStoreAccess(fullText) // env.X where env is likely an env config object
615
1859
  ) {
616
1860
  context.addEnvironmentVariable(fullText);
617
1861
  }
@@ -918,6 +2162,14 @@ export function processExpression({
918
2162
  // e.g., `const tab = segments[0] || 'default'` should trace tab back to segments[0]
919
2163
  if (operatorKind === ts.SyntaxKind.QuestionQuestionToken) {
920
2164
  // specifically for ?? we create an equivalence to the left side
2165
+ // IMPORTANT: Also process the left side recursively to apply method semantics
2166
+ // (e.g., for `const segments = splat?.split('/') ?? []`, we need split semantics)
2167
+ processExpression({
2168
+ node: unwrappedNode.left,
2169
+ context,
2170
+ // Don't pass targetPath here - we'll establish equivalence separately below
2171
+ });
2172
+
921
2173
  if (targetPath) {
922
2174
  resultPath = StructuredPath.fromNode(
923
2175
  unwrappedNode.left,
@@ -935,15 +2187,55 @@ export function processExpression({
935
2187
  );
936
2188
  }
937
2189
  } else if (operatorKind === ts.SyntaxKind.BarBarToken) {
938
- // For ||, also create an equivalence to the left side
2190
+ // For ||, create equivalences to BOTH sides
939
2191
  // This enables data flow tracing through fallback expressions
2192
+ // e.g., `const item = items.find(...) || null` should trace to both:
2193
+ // - items[] (from the find result)
2194
+ // - null (from the fallback)
940
2195
  if (targetPath) {
941
- resultPath = StructuredPath.fromNode(
2196
+ // Get paths for both sides
2197
+ const leftPath = StructuredPath.fromNode(
942
2198
  unwrappedNode.left,
943
2199
  context.sourceFile,
944
2200
  );
2201
+ const rightPath = StructuredPath.fromNode(
2202
+ unwrappedNode.right,
2203
+ context.sourceFile,
2204
+ );
2205
+
2206
+ // Collect all valid paths
2207
+ const allPaths: StructuredPath[] = [];
2208
+ if (leftPath) allPaths.push(leftPath);
2209
+ if (rightPath) allPaths.push(rightPath);
2210
+
2211
+ // Add multiple equivalencies to track both sources
2212
+ if (allPaths.length > 0) {
2213
+ context.addMultipleEquivalencies(targetPath, allPaths);
2214
+ }
2215
+
2216
+ // Process both sides to capture their internal structures
2217
+ processExpression({
2218
+ node: unwrappedNode.left,
2219
+ context,
2220
+ });
2221
+ processExpression({
2222
+ node: unwrappedNode.right,
2223
+ context,
2224
+ });
2225
+
2226
+ // Register the type for the target path
2227
+ const leftType = context.inferTypeFromNode(unwrappedNode.left);
2228
+ const rightType = context.inferTypeFromNode(unwrappedNode.right);
2229
+ const orResultType = isDefinedType(leftType)
2230
+ ? leftType
2231
+ : rightType || 'unknown';
2232
+ context.addType(targetPath, orResultType);
2233
+
2234
+ // Return early - we've already handled equivalencies with addMultipleEquivalencies
2235
+ // Don't fall through to the generic addEquivalence call below
2236
+ return true;
945
2237
  }
946
- // Note: Unlike ??, we don't set targetPath when there's no target
2238
+ // Note: When there's no targetPath, we don't recursively process
947
2239
  // because || is often used in boolean contexts where the full expression matters
948
2240
  }
949
2241
  } else if (operatorKind === ts.SyntaxKind.InstanceOfKeyword) {
@@ -1051,24 +2343,56 @@ export function processExpression({
1051
2343
 
1052
2344
  // Get the source expression path (e.g., the object for obj.method())
1053
2345
  const sourceExpr = unwrappedNode.expression.expression;
1054
- const sourcePath = StructuredPath.fromNode(
1055
- sourceExpr,
1056
- context.sourceFile,
1057
- );
1058
-
1059
- if (sourcePath) {
1060
- // For array-specific semantics (like push), verify the source is actually an array
1061
- // This prevents router.push() from being mistakenly treated as Array.push()
1062
- const isArraySemantics = semantics instanceof ArrayPushSemantics;
1063
- const shouldApply =
1064
- !isArraySemantics ||
1065
- isLikelyArrayType(sourceExpr, context.typeChecker);
2346
+ const unwrappedSourceExpr = unwrapExpression(sourceExpr);
2347
+
2348
+ // When the source is a ternary expression like (cond ? arr : arr.slice()),
2349
+ // apply method semantics to BOTH branches directly. The ternary itself isn't
2350
+ // a variable - it's just a choice between two paths that both flow to the result.
2351
+ if (ts.isConditionalExpression(unwrappedSourceExpr)) {
2352
+ const branches = [
2353
+ unwrappedSourceExpr.whenTrue,
2354
+ unwrappedSourceExpr.whenFalse,
2355
+ ];
2356
+
2357
+ for (const branch of branches) {
2358
+ const branchPath = StructuredPath.fromNode(
2359
+ branch,
2360
+ context.sourceFile,
2361
+ );
2362
+ if (branchPath) {
2363
+ const isArraySemantics = semantics instanceof ArrayPushSemantics;
2364
+ const shouldApply =
2365
+ !isArraySemantics ||
2366
+ isLikelyArrayType(branch, context.typeChecker);
2367
+
2368
+ if (shouldApply) {
2369
+ semantics.addEquivalences(callPath, branchPath, context);
2370
+ returnType = semantics.getReturnType();
2371
+ handledBySemantics = true;
2372
+ }
2373
+ }
2374
+ }
2375
+ } else {
2376
+ // Regular (non-ternary) source expression
2377
+ const sourcePath = StructuredPath.fromNode(
2378
+ sourceExpr,
2379
+ context.sourceFile,
2380
+ );
1066
2381
 
1067
- if (shouldApply) {
1068
- // Apply method semantics
1069
- semantics.addEquivalences(callPath, sourcePath, context);
1070
- returnType = semantics.getReturnType();
1071
- handledBySemantics = true;
2382
+ if (sourcePath) {
2383
+ // For array-specific semantics (like push), verify the source is actually an array
2384
+ // This prevents router.push() from being mistakenly treated as Array.push()
2385
+ const isArraySemantics = semantics instanceof ArrayPushSemantics;
2386
+ const shouldApply =
2387
+ !isArraySemantics ||
2388
+ isLikelyArrayType(sourceExpr, context.typeChecker);
2389
+
2390
+ if (shouldApply) {
2391
+ // Apply method semantics
2392
+ semantics.addEquivalences(callPath, sourcePath, context);
2393
+ returnType = semantics.getReturnType();
2394
+ handledBySemantics = true;
2395
+ }
1072
2396
  }
1073
2397
  }
1074
2398
  }
@@ -1482,6 +2806,17 @@ export function processExpression({
1482
2806
  // Extract conditional usages for key attribute detection
1483
2807
  extractConditionalUsage(unwrappedNode.condition, context, 'ternary');
1484
2808
 
2809
+ // Extract conditional effects (setter calls in ternary branches)
2810
+ const knownSetters = findUseStateSetters(context.sourceFile);
2811
+ const effects = extractConditionalEffectsFromTernary(
2812
+ unwrappedNode,
2813
+ context,
2814
+ knownSetters,
2815
+ );
2816
+ for (const effect of effects) {
2817
+ context.addConditionalEffect(effect);
2818
+ }
2819
+
1485
2820
  // Process all parts recursively
1486
2821
  processExpression({
1487
2822
  node: unwrappedNode.condition,
@@ -1615,6 +2950,35 @@ export function processExpression({
1615
2950
 
1616
2951
  // Handle Arrow Functions: (p) => p.prop, (a, b) => { ... }
1617
2952
  if (ts.isArrowFunction(unwrappedNode)) {
2953
+ // If this arrow function is a child boundary (e.g., a .map() callback),
2954
+ // don't process its parameters here - they will be processed when the
2955
+ // child scope is analyzed separately. This prevents parameter variables
2956
+ // from leaking into the parent scope's equivalencies.
2957
+ // Check if this arrow function is a child boundary (i.e., should be processed
2958
+ // as a separate child scope, not here in the parent scope).
2959
+ //
2960
+ // We use two checks because childBoundary positions can be unreliable:
2961
+ // 1. Position-based check (standard isChildBoundary)
2962
+ // 2. Text-based check: if the arrow function text doesn't appear in the
2963
+ // statement text, it was replaced with a cyScope placeholder
2964
+ const isChildBoundary = context.isChildBoundary(unwrappedNode);
2965
+
2966
+ // Text-based child scope detection for when positions are unreliable
2967
+ const arrowFnText = unwrappedNode.getText(context.sourceFile);
2968
+ const firstLine = arrowFnText.split('\n')[0].trim();
2969
+ const searchText = firstLine.substring(0, Math.min(20, firstLine.length));
2970
+ const isInStatementText = context.statementInfo.text.includes(searchText);
2971
+ const isChildScope = !isInStatementText && arrowFnText.length > 10;
2972
+
2973
+ if (isChildBoundary || isChildScope) {
2974
+ // The method semantics (e.g., ArrayMapSemantics) have already established
2975
+ // the necessary equivalences between the child scope placeholder and array elements
2976
+ if (targetPath) {
2977
+ context.addType(targetPath, 'function');
2978
+ }
2979
+ return true;
2980
+ }
2981
+
1618
2982
  // Create a path for the function
1619
2983
  const functionPath = StructuredPath.empty();
1620
2984
 
@@ -2045,6 +3409,19 @@ export function processExpression({
2045
3409
  for (const child of unwrappedNode.children) {
2046
3410
  // Process expressions in JSX children: <div>{expr}</div>
2047
3411
  if (ts.isJsxExpression(child) && child.expression) {
3412
+ // When processing return value JSX, link root variables to return value schema
3413
+ if (targetPath && targetPath.base !== '') {
3414
+ const varNames = [
3415
+ ...new Set(extractRootVariableNames(child.expression)),
3416
+ ];
3417
+ for (const varName of varNames) {
3418
+ context.addEquivalence(
3419
+ targetPath.withProperty(varName),
3420
+ StructuredPath.fromBase(varName),
3421
+ );
3422
+ }
3423
+ }
3424
+
2048
3425
  // Process the expression with StructuredPath.empty() as targetPath
2049
3426
  // to trigger type registration without imposing prefix
2050
3427
  processExpression({
@@ -2079,6 +3456,19 @@ export function processExpression({
2079
3456
  for (const child of unwrappedNode.children) {
2080
3457
  // Process expressions in JSX children: <>{expr}</>
2081
3458
  if (ts.isJsxExpression(child) && child.expression) {
3459
+ // When processing return value JSX, link root variables to return value schema
3460
+ if (targetPath && targetPath.base !== '') {
3461
+ const varNames = [
3462
+ ...new Set(extractRootVariableNames(child.expression)),
3463
+ ];
3464
+ for (const varName of varNames) {
3465
+ context.addEquivalence(
3466
+ targetPath.withProperty(varName),
3467
+ StructuredPath.fromBase(varName),
3468
+ );
3469
+ }
3470
+ }
3471
+
2082
3472
  // Process the expression to extract structure
2083
3473
  processExpression({
2084
3474
  node: child.expression,