@codeyam/codeyam-cli 0.1.7 → 0.1.9

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 (576) hide show
  1. package/analyzer-template/.build-info.json +8 -8
  2. package/analyzer-template/log.txt +3 -3
  3. package/analyzer-template/package.json +9 -9
  4. package/analyzer-template/packages/ai/package.json +1 -1
  5. package/analyzer-template/packages/ai/src/lib/astScopes/astScopeAnalyzer.ts +34 -3
  6. package/analyzer-template/packages/ai/src/lib/completionCall.ts +14 -2
  7. package/analyzer-template/packages/ai/src/lib/dataStructure/ScopeDataStructure.ts +27 -0
  8. package/analyzer-template/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.ts +62 -0
  9. package/analyzer-template/packages/ai/src/lib/generateEntityScenarioData.ts +78 -2
  10. package/analyzer-template/packages/ai/src/lib/generateExecutionFlows.ts +0 -33
  11. package/analyzer-template/packages/analyze/src/lib/ProjectAnalyzer.ts +19 -7
  12. package/analyzer-template/packages/analyze/src/lib/asts/index.ts +7 -2
  13. package/analyzer-template/packages/analyze/src/lib/files/analyze/analyzeEntities.ts +9 -1
  14. package/analyzer-template/packages/analyze/src/lib/files/analyze/dependencyResolver.ts +0 -6
  15. package/analyzer-template/packages/analyze/src/lib/files/analyze/findOrCreateEntity.ts +12 -0
  16. package/analyzer-template/packages/analyze/src/lib/files/scenarios/TransformationTracer.ts +65 -28
  17. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateDataStructure.ts +83 -0
  18. package/analyzer-template/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.ts +0 -98
  19. package/analyzer-template/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.ts +23 -4
  20. package/analyzer-template/packages/aws/package.json +2 -2
  21. package/analyzer-template/packages/database/index.ts +1 -0
  22. package/analyzer-template/packages/database/package.json +3 -3
  23. package/analyzer-template/packages/database/src/lib/kysely/db.ts +8 -0
  24. package/analyzer-template/packages/database/src/lib/kysely/tables/editorScenariosTable.ts +93 -0
  25. package/analyzer-template/packages/database/src/lib/loadCommits.ts +31 -20
  26. package/analyzer-template/packages/database/src/lib/loadEntities.ts +0 -6
  27. package/analyzer-template/packages/database/src/lib/loadReadyToBeCapturedAnalyses.ts +0 -5
  28. package/analyzer-template/packages/database/src/lib/updateCommitMetadata.ts +94 -143
  29. package/analyzer-template/packages/database/src/lib/updateFreshAnalysisStatus.ts +58 -42
  30. package/analyzer-template/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.ts +81 -65
  31. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.ts +29 -1
  32. package/analyzer-template/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.ts +33 -5
  33. package/analyzer-template/packages/github/dist/database/index.d.ts +1 -0
  34. package/analyzer-template/packages/github/dist/database/index.d.ts.map +1 -1
  35. package/analyzer-template/packages/github/dist/database/index.js +1 -0
  36. package/analyzer-template/packages/github/dist/database/index.js.map +1 -1
  37. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts +2 -0
  38. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.d.ts.map +1 -1
  39. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js +5 -0
  40. package/analyzer-template/packages/github/dist/database/src/lib/kysely/db.js.map +1 -1
  41. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.d.ts +25 -0
  42. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.d.ts.map +1 -0
  43. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.js +76 -0
  44. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/editorScenariosTable.js.map +1 -0
  45. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts +5 -0
  46. package/analyzer-template/packages/github/dist/database/src/lib/kysely/tables/scenariosTable.d.ts.map +1 -1
  47. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.d.ts.map +1 -1
  48. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js +23 -13
  49. package/analyzer-template/packages/github/dist/database/src/lib/loadCommits.js.map +1 -1
  50. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.d.ts.map +1 -1
  51. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js +0 -6
  52. package/analyzer-template/packages/github/dist/database/src/lib/loadEntities.js.map +1 -1
  53. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.d.ts.map +1 -1
  54. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js +1 -4
  55. package/analyzer-template/packages/github/dist/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  56. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.d.ts.map +1 -1
  57. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js +76 -90
  58. package/analyzer-template/packages/github/dist/database/src/lib/updateCommitMetadata.js.map +1 -1
  59. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.d.ts.map +1 -1
  60. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.js +41 -30
  61. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatus.js.map +1 -1
  62. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.d.ts.map +1 -1
  63. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.js +68 -57
  64. package/analyzer-template/packages/github/dist/database/src/lib/updateFreshAnalysisStatusWithScenarios.js.map +1 -1
  65. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.d.ts.map +1 -1
  66. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +29 -1
  67. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -1
  68. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.d.ts.map +1 -1
  69. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js +33 -5
  70. package/analyzer-template/packages/github/dist/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js.map +1 -1
  71. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.d.ts +2 -0
  72. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.d.ts.map +1 -1
  73. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.js +2 -0
  74. package/analyzer-template/packages/github/dist/types/src/enums/ProjectFramework.js.map +1 -1
  75. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts +1 -0
  76. package/analyzer-template/packages/github/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  77. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts +10 -0
  78. package/analyzer-template/packages/github/dist/types/src/types/Scenario.d.ts.map +1 -1
  79. package/analyzer-template/packages/github/package.json +1 -1
  80. package/analyzer-template/packages/types/src/enums/ProjectFramework.ts +2 -0
  81. package/analyzer-template/packages/types/src/types/ProjectMetadata.ts +1 -0
  82. package/analyzer-template/packages/types/src/types/Scenario.ts +10 -0
  83. package/analyzer-template/packages/ui-components/package.json +1 -1
  84. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.d.ts +2 -0
  85. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.d.ts.map +1 -1
  86. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.js +2 -0
  87. package/analyzer-template/packages/utils/dist/types/src/enums/ProjectFramework.js.map +1 -1
  88. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts +1 -0
  89. package/analyzer-template/packages/utils/dist/types/src/types/ProjectMetadata.d.ts.map +1 -1
  90. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts +10 -0
  91. package/analyzer-template/packages/utils/dist/types/src/types/Scenario.d.ts.map +1 -1
  92. package/analyzer-template/playwright/captureFromUrl.ts +89 -82
  93. package/analyzer-template/project/constructMockCode.ts +136 -43
  94. package/analyzer-template/project/reconcileMockDataKeys.ts +19 -14
  95. package/analyzer-template/project/start.ts +3 -0
  96. package/analyzer-template/project/startScenarioCapture.ts +9 -0
  97. package/analyzer-template/project/writeClientLogRoute.ts +125 -0
  98. package/analyzer-template/project/writeMockDataTsx.ts +17 -0
  99. package/analyzer-template/project/writeScenarioComponents.ts +36 -7
  100. package/analyzer-template/tsconfig.json +13 -1
  101. package/background/src/lib/virtualized/project/constructMockCode.js +115 -34
  102. package/background/src/lib/virtualized/project/constructMockCode.js.map +1 -1
  103. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js +17 -11
  104. package/background/src/lib/virtualized/project/reconcileMockDataKeys.js.map +1 -1
  105. package/background/src/lib/virtualized/project/start.js +2 -0
  106. package/background/src/lib/virtualized/project/start.js.map +1 -1
  107. package/background/src/lib/virtualized/project/startScenarioCapture.js +5 -0
  108. package/background/src/lib/virtualized/project/startScenarioCapture.js.map +1 -1
  109. package/background/src/lib/virtualized/project/writeClientLogRoute.js +110 -0
  110. package/background/src/lib/virtualized/project/writeClientLogRoute.js.map +1 -0
  111. package/background/src/lib/virtualized/project/writeMockDataTsx.js +12 -0
  112. package/background/src/lib/virtualized/project/writeMockDataTsx.js.map +1 -1
  113. package/background/src/lib/virtualized/project/writeScenarioComponents.js +29 -7
  114. package/background/src/lib/virtualized/project/writeScenarioComponents.js.map +1 -1
  115. package/codeyam-cli/scripts/apply-setup.js +208 -11
  116. package/codeyam-cli/scripts/apply-setup.js.map +1 -1
  117. package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js +196 -0
  118. package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js.map +1 -0
  119. package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js +114 -0
  120. package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js.map +1 -0
  121. package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js +149 -0
  122. package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js.map +1 -0
  123. package/codeyam-cli/src/cli.js +2 -0
  124. package/codeyam-cli/src/cli.js.map +1 -1
  125. package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js +45 -0
  126. package/codeyam-cli/src/commands/__tests__/editor.stepDispatch.test.js.map +1 -0
  127. package/codeyam-cli/src/commands/__tests__/init.gitignore.test.js +101 -47
  128. package/codeyam-cli/src/commands/__tests__/init.gitignore.test.js.map +1 -1
  129. package/codeyam-cli/src/commands/analyze.js +17 -7
  130. package/codeyam-cli/src/commands/analyze.js.map +1 -1
  131. package/codeyam-cli/src/commands/default.js +14 -2
  132. package/codeyam-cli/src/commands/default.js.map +1 -1
  133. package/codeyam-cli/src/commands/editor.js +3215 -0
  134. package/codeyam-cli/src/commands/editor.js.map +1 -0
  135. package/codeyam-cli/src/commands/init.js +107 -45
  136. package/codeyam-cli/src/commands/init.js.map +1 -1
  137. package/codeyam-cli/src/data/techStacks.js +77 -0
  138. package/codeyam-cli/src/data/techStacks.js.map +1 -0
  139. package/codeyam-cli/src/utils/__tests__/analyzerFinalization.test.js +144 -0
  140. package/codeyam-cli/src/utils/__tests__/analyzerFinalization.test.js.map +1 -0
  141. package/codeyam-cli/src/utils/__tests__/backgroundServer.test.js +46 -0
  142. package/codeyam-cli/src/utils/__tests__/backgroundServer.test.js.map +1 -0
  143. package/codeyam-cli/src/utils/__tests__/devServerState.test.js +134 -0
  144. package/codeyam-cli/src/utils/__tests__/devServerState.test.js.map +1 -0
  145. package/codeyam-cli/src/utils/__tests__/editorApi.test.js +127 -0
  146. package/codeyam-cli/src/utils/__tests__/editorApi.test.js.map +1 -0
  147. package/codeyam-cli/src/utils/__tests__/editorAudit.test.js +855 -0
  148. package/codeyam-cli/src/utils/__tests__/editorAudit.test.js.map +1 -0
  149. package/codeyam-cli/src/utils/__tests__/editorCapture.test.js +93 -0
  150. package/codeyam-cli/src/utils/__tests__/editorCapture.test.js.map +1 -0
  151. package/codeyam-cli/src/utils/__tests__/editorDevServer.test.js +304 -0
  152. package/codeyam-cli/src/utils/__tests__/editorDevServer.test.js.map +1 -0
  153. package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js +121 -0
  154. package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js.map +1 -0
  155. package/codeyam-cli/src/utils/__tests__/editorImageVerifier.test.js +294 -0
  156. package/codeyam-cli/src/utils/__tests__/editorImageVerifier.test.js.map +1 -0
  157. package/codeyam-cli/src/utils/__tests__/editorJournal.test.js +542 -0
  158. package/codeyam-cli/src/utils/__tests__/editorJournal.test.js.map +1 -0
  159. package/codeyam-cli/src/utils/__tests__/editorLoaderHelpers.test.js +520 -0
  160. package/codeyam-cli/src/utils/__tests__/editorLoaderHelpers.test.js.map +1 -0
  161. package/codeyam-cli/src/utils/__tests__/editorMockState.test.js +270 -0
  162. package/codeyam-cli/src/utils/__tests__/editorMockState.test.js.map +1 -0
  163. package/codeyam-cli/src/utils/__tests__/editorPreloadHelpers.test.js +217 -0
  164. package/codeyam-cli/src/utils/__tests__/editorPreloadHelpers.test.js.map +1 -0
  165. package/codeyam-cli/src/utils/__tests__/editorPreview.test.js +339 -0
  166. package/codeyam-cli/src/utils/__tests__/editorPreview.test.js.map +1 -0
  167. package/codeyam-cli/src/utils/__tests__/editorProxySession.test.js +153 -0
  168. package/codeyam-cli/src/utils/__tests__/editorProxySession.test.js.map +1 -0
  169. package/codeyam-cli/src/utils/__tests__/editorScenarioLookup.test.js +139 -0
  170. package/codeyam-cli/src/utils/__tests__/editorScenarioLookup.test.js.map +1 -0
  171. package/codeyam-cli/src/utils/__tests__/editorScenarioSwitch.test.js +221 -0
  172. package/codeyam-cli/src/utils/__tests__/editorScenarioSwitch.test.js.map +1 -0
  173. package/codeyam-cli/src/utils/__tests__/editorScenarios.test.js +855 -0
  174. package/codeyam-cli/src/utils/__tests__/editorScenarios.test.js.map +1 -0
  175. package/codeyam-cli/src/utils/__tests__/editorSeedAdapter.test.js +213 -0
  176. package/codeyam-cli/src/utils/__tests__/editorSeedAdapter.test.js.map +1 -0
  177. package/codeyam-cli/src/utils/__tests__/entityChangeStatus.test.js +1742 -0
  178. package/codeyam-cli/src/utils/__tests__/entityChangeStatus.test.js.map +1 -0
  179. package/codeyam-cli/src/utils/__tests__/git.editor.test.js +134 -0
  180. package/codeyam-cli/src/utils/__tests__/git.editor.test.js.map +1 -0
  181. package/codeyam-cli/src/utils/__tests__/journalCaptureStabilization.test.js +107 -0
  182. package/codeyam-cli/src/utils/__tests__/journalCaptureStabilization.test.js.map +1 -0
  183. package/codeyam-cli/src/utils/__tests__/parseRegisterArg.test.js +101 -0
  184. package/codeyam-cli/src/utils/__tests__/parseRegisterArg.test.js.map +1 -0
  185. package/codeyam-cli/src/utils/__tests__/pathIgnoring.test.js +9 -0
  186. package/codeyam-cli/src/utils/__tests__/pathIgnoring.test.js.map +1 -1
  187. package/codeyam-cli/src/utils/__tests__/project.test.js +65 -0
  188. package/codeyam-cli/src/utils/__tests__/project.test.js.map +1 -0
  189. package/codeyam-cli/src/utils/__tests__/scenarioCoverage.test.js +227 -0
  190. package/codeyam-cli/src/utils/__tests__/scenarioCoverage.test.js.map +1 -0
  191. package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js +121 -0
  192. package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js.map +1 -0
  193. package/codeyam-cli/src/utils/__tests__/scenariosManifest.test.js +300 -0
  194. package/codeyam-cli/src/utils/__tests__/scenariosManifest.test.js.map +1 -0
  195. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js +50 -4
  196. package/codeyam-cli/src/utils/__tests__/setupClaudeCodeSettings.test.js.map +1 -1
  197. package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js +51 -0
  198. package/codeyam-cli/src/utils/__tests__/templateConsistency.test.js.map +1 -0
  199. package/codeyam-cli/src/utils/__tests__/webappDetection.test.js +142 -0
  200. package/codeyam-cli/src/utils/__tests__/webappDetection.test.js.map +1 -0
  201. package/codeyam-cli/src/utils/analyzer.js +9 -0
  202. package/codeyam-cli/src/utils/analyzer.js.map +1 -1
  203. package/codeyam-cli/src/utils/analyzerFinalization.js +96 -0
  204. package/codeyam-cli/src/utils/analyzerFinalization.js.map +1 -0
  205. package/codeyam-cli/src/utils/backgroundServer.js +104 -12
  206. package/codeyam-cli/src/utils/backgroundServer.js.map +1 -1
  207. package/codeyam-cli/src/utils/buildFlags.js +4 -0
  208. package/codeyam-cli/src/utils/buildFlags.js.map +1 -0
  209. package/codeyam-cli/src/utils/database.js +37 -2
  210. package/codeyam-cli/src/utils/database.js.map +1 -1
  211. package/codeyam-cli/src/utils/devModeEvents.js +40 -0
  212. package/codeyam-cli/src/utils/devModeEvents.js.map +1 -0
  213. package/codeyam-cli/src/utils/devServerState.js +71 -0
  214. package/codeyam-cli/src/utils/devServerState.js.map +1 -0
  215. package/codeyam-cli/src/utils/editorApi.js +73 -0
  216. package/codeyam-cli/src/utils/editorApi.js.map +1 -0
  217. package/codeyam-cli/src/utils/editorAudit.js +176 -0
  218. package/codeyam-cli/src/utils/editorAudit.js.map +1 -0
  219. package/codeyam-cli/src/utils/editorCapture.js +102 -0
  220. package/codeyam-cli/src/utils/editorCapture.js.map +1 -0
  221. package/codeyam-cli/src/utils/editorDevServer.js +197 -0
  222. package/codeyam-cli/src/utils/editorDevServer.js.map +1 -0
  223. package/codeyam-cli/src/utils/editorEntityChangeStatus.js +44 -0
  224. package/codeyam-cli/src/utils/editorEntityChangeStatus.js.map +1 -0
  225. package/codeyam-cli/src/utils/editorImageVerifier.js +155 -0
  226. package/codeyam-cli/src/utils/editorImageVerifier.js.map +1 -0
  227. package/codeyam-cli/src/utils/editorJournal.js +225 -0
  228. package/codeyam-cli/src/utils/editorJournal.js.map +1 -0
  229. package/codeyam-cli/src/utils/editorLoaderHelpers.js +113 -0
  230. package/codeyam-cli/src/utils/editorLoaderHelpers.js.map +1 -0
  231. package/codeyam-cli/src/utils/editorMockState.js +248 -0
  232. package/codeyam-cli/src/utils/editorMockState.js.map +1 -0
  233. package/codeyam-cli/src/utils/editorPreloadHelpers.js +135 -0
  234. package/codeyam-cli/src/utils/editorPreloadHelpers.js.map +1 -0
  235. package/codeyam-cli/src/utils/editorPreview.js +132 -0
  236. package/codeyam-cli/src/utils/editorPreview.js.map +1 -0
  237. package/codeyam-cli/src/utils/editorScenarioSwitch.js +112 -0
  238. package/codeyam-cli/src/utils/editorScenarioSwitch.js.map +1 -0
  239. package/codeyam-cli/src/utils/editorScenarios.js +332 -0
  240. package/codeyam-cli/src/utils/editorScenarios.js.map +1 -0
  241. package/codeyam-cli/src/utils/editorSeedAdapter.js +173 -0
  242. package/codeyam-cli/src/utils/editorSeedAdapter.js.map +1 -0
  243. package/codeyam-cli/src/utils/entityChangeStatus.js +349 -0
  244. package/codeyam-cli/src/utils/entityChangeStatus.js.map +1 -0
  245. package/codeyam-cli/src/utils/entityChangeStatus.server.js +158 -0
  246. package/codeyam-cli/src/utils/entityChangeStatus.server.js.map +1 -0
  247. package/codeyam-cli/src/utils/fileMetadata.js +5 -0
  248. package/codeyam-cli/src/utils/fileMetadata.js.map +1 -1
  249. package/codeyam-cli/src/utils/fileWatcher.js +25 -9
  250. package/codeyam-cli/src/utils/fileWatcher.js.map +1 -1
  251. package/codeyam-cli/src/utils/git.js +103 -0
  252. package/codeyam-cli/src/utils/git.js.map +1 -1
  253. package/codeyam-cli/src/utils/install-skills.js +55 -13
  254. package/codeyam-cli/src/utils/install-skills.js.map +1 -1
  255. package/codeyam-cli/src/utils/interactiveSyncWatcher.js +126 -0
  256. package/codeyam-cli/src/utils/interactiveSyncWatcher.js.map +1 -0
  257. package/codeyam-cli/src/utils/parseRegisterArg.js +31 -0
  258. package/codeyam-cli/src/utils/parseRegisterArg.js.map +1 -0
  259. package/codeyam-cli/src/utils/pathIgnoring.js +19 -7
  260. package/codeyam-cli/src/utils/pathIgnoring.js.map +1 -1
  261. package/codeyam-cli/src/utils/project.js +15 -5
  262. package/codeyam-cli/src/utils/project.js.map +1 -1
  263. package/codeyam-cli/src/utils/queue/__tests__/heartbeat.test.js +11 -11
  264. package/codeyam-cli/src/utils/queue/__tests__/heartbeat.test.js.map +1 -1
  265. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js +22 -0
  266. package/codeyam-cli/src/utils/queue/__tests__/manager.test.js.map +1 -1
  267. package/codeyam-cli/src/utils/queue/heartbeat.js +13 -5
  268. package/codeyam-cli/src/utils/queue/heartbeat.js.map +1 -1
  269. package/codeyam-cli/src/utils/queue/job.js +70 -1
  270. package/codeyam-cli/src/utils/queue/job.js.map +1 -1
  271. package/codeyam-cli/src/utils/queue/manager.js +7 -6
  272. package/codeyam-cli/src/utils/queue/manager.js.map +1 -1
  273. package/codeyam-cli/src/utils/scenarioCoverage.js +75 -0
  274. package/codeyam-cli/src/utils/scenarioCoverage.js.map +1 -0
  275. package/codeyam-cli/src/utils/scenarioMarkers.js +134 -0
  276. package/codeyam-cli/src/utils/scenarioMarkers.js.map +1 -0
  277. package/codeyam-cli/src/utils/scenariosManifest.js +159 -0
  278. package/codeyam-cli/src/utils/scenariosManifest.js.map +1 -0
  279. package/codeyam-cli/src/utils/serverState.js +57 -2
  280. package/codeyam-cli/src/utils/serverState.js.map +1 -1
  281. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js +82 -11
  282. package/codeyam-cli/src/utils/setupClaudeCodeSettings.js.map +1 -1
  283. package/codeyam-cli/src/utils/simulationGateMiddleware.js +8 -1
  284. package/codeyam-cli/src/utils/simulationGateMiddleware.js.map +1 -1
  285. package/codeyam-cli/src/utils/slugUtils.js +25 -0
  286. package/codeyam-cli/src/utils/slugUtils.js.map +1 -0
  287. package/codeyam-cli/src/utils/syncMocksMiddleware.js +2 -2
  288. package/codeyam-cli/src/utils/syncMocksMiddleware.js.map +1 -1
  289. package/codeyam-cli/src/utils/testRunner.js +158 -0
  290. package/codeyam-cli/src/utils/testRunner.js.map +1 -0
  291. package/codeyam-cli/src/utils/webappDetection.js +35 -2
  292. package/codeyam-cli/src/utils/webappDetection.js.map +1 -1
  293. package/codeyam-cli/src/webserver/__tests__/clientErrors.test.js +40 -0
  294. package/codeyam-cli/src/webserver/__tests__/clientErrors.test.js.map +1 -0
  295. package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js +567 -0
  296. package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js.map +1 -0
  297. package/codeyam-cli/src/webserver/app/lib/clientErrors.js +65 -0
  298. package/codeyam-cli/src/webserver/app/lib/clientErrors.js.map +1 -0
  299. package/codeyam-cli/src/webserver/app/lib/database.js +41 -27
  300. package/codeyam-cli/src/webserver/app/lib/database.js.map +1 -1
  301. package/codeyam-cli/src/webserver/app/lib/dbNotifier.js.map +1 -1
  302. package/codeyam-cli/src/webserver/app/lib/git.js +397 -0
  303. package/codeyam-cli/src/webserver/app/lib/git.js.map +1 -0
  304. package/codeyam-cli/src/webserver/backgroundServer.js +108 -18
  305. package/codeyam-cli/src/webserver/backgroundServer.js.map +1 -1
  306. package/codeyam-cli/src/webserver/build/client/assets/{CopyButton-CtmbP4Gl.js → CopyButton-BPXZwM4t.js} +1 -1
  307. package/codeyam-cli/src/webserver/build/client/assets/{EntityItem-DlMph_Hm.js → EntityItem-BcgbViKV.js} +3 -3
  308. package/codeyam-cli/src/webserver/build/client/assets/{EntityTypeBadge-B-0PjGOU.js → EntityTypeBadge-g3saevPb.js} +1 -1
  309. package/codeyam-cli/src/webserver/build/client/assets/{EntityTypeIcon-DN9eiJAO.js → EntityTypeIcon-CQIG2qda.js} +9 -9
  310. package/codeyam-cli/src/webserver/build/client/assets/InlineSpinner-Bu6c6aDe.js +1 -0
  311. package/codeyam-cli/src/webserver/build/client/assets/{InteractivePreview-rE_fI2h2.js → InteractivePreview-DYFW3lDD.js} +3 -3
  312. package/codeyam-cli/src/webserver/build/client/assets/{LibraryFunctionPreview-CnatsCw2.js → LibraryFunctionPreview-DLeucoVX.js} +1 -1
  313. package/codeyam-cli/src/webserver/build/client/assets/{LoadingDots-CSP6DZrh.js → LoadingDots-BU_OAEMP.js} +1 -1
  314. package/codeyam-cli/src/webserver/build/client/assets/{LogViewer-CMK8Q7yk.js → LogViewer-ceAyBX-H.js} +1 -1
  315. package/codeyam-cli/src/webserver/build/client/assets/{ReportIssueModal-TCV_HBjy.js → ReportIssueModal-BzHcG7SE.js} +3 -3
  316. package/codeyam-cli/src/webserver/build/client/assets/{SafeScreenshot-CG2uh31y.js → SafeScreenshot-BED4B6sP.js} +1 -1
  317. package/codeyam-cli/src/webserver/build/client/assets/{ScenarioViewer-CU_TDYd8.js → ScenarioViewer-Bd-hxofb.js} +3 -3
  318. package/codeyam-cli/src/webserver/build/client/assets/Spinner-Bb5uFQ5V.js +34 -0
  319. package/codeyam-cli/src/webserver/build/client/assets/{TruncatedFilePath-D7IoaWUW.js → TruncatedFilePath-C8OKAR5x.js} +1 -1
  320. package/codeyam-cli/src/webserver/build/client/assets/ViewportInspectBar-oAf2Kqsf.js +1 -0
  321. package/codeyam-cli/src/webserver/build/client/assets/{_index-B8z7mjR-.js → _index-DLxKhri3.js} +3 -3
  322. package/codeyam-cli/src/webserver/build/client/assets/{activity.(_tab)-DZu78RI1.js → activity.(_tab)-BcY3q6nt.js} +6 -6
  323. package/codeyam-cli/src/webserver/build/client/assets/addon-canvas-DpzMmAy5.js +1 -0
  324. package/codeyam-cli/src/webserver/build/client/assets/addon-fit-YJmn1quW.js +12 -0
  325. package/codeyam-cli/src/webserver/build/client/assets/addon-web-links-Duc5hnl7.js +1 -0
  326. package/codeyam-cli/src/webserver/build/client/assets/addon-webgl-DI8QOUvO.js +58 -0
  327. package/codeyam-cli/src/webserver/build/client/assets/{agent-transcripts-Dm5RS9il.js → agent-transcripts-Bni3iiUj.js} +5 -5
  328. package/codeyam-cli/src/webserver/build/client/assets/api.dev-mode-events-l0sNRNKZ.js +1 -0
  329. package/codeyam-cli/src/webserver/build/client/assets/api.editor-audit-l0sNRNKZ.js +1 -0
  330. package/codeyam-cli/src/webserver/build/client/assets/api.editor-capture-scenario-l0sNRNKZ.js +1 -0
  331. package/codeyam-cli/src/webserver/build/client/assets/api.editor-client-errors-l0sNRNKZ.js +1 -0
  332. package/codeyam-cli/src/webserver/build/client/assets/api.editor-commit-l0sNRNKZ.js +1 -0
  333. package/codeyam-cli/src/webserver/build/client/assets/api.editor-dev-server-l0sNRNKZ.js +1 -0
  334. package/codeyam-cli/src/webserver/build/client/assets/api.editor-entity-status-l0sNRNKZ.js +1 -0
  335. package/codeyam-cli/src/webserver/build/client/assets/api.editor-file-diff-l0sNRNKZ.js +1 -0
  336. package/codeyam-cli/src/webserver/build/client/assets/api.editor-file-l0sNRNKZ.js +1 -0
  337. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-entry-l0sNRNKZ.js +1 -0
  338. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-image._-l0sNRNKZ.js +1 -0
  339. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-l0sNRNKZ.js +1 -0
  340. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-screenshot-l0sNRNKZ.js +1 -0
  341. package/codeyam-cli/src/webserver/build/client/assets/api.editor-journal-update-l0sNRNKZ.js +1 -0
  342. package/codeyam-cli/src/webserver/build/client/assets/api.editor-load-commit-l0sNRNKZ.js +1 -0
  343. package/codeyam-cli/src/webserver/build/client/assets/api.editor-project-info-l0sNRNKZ.js +1 -0
  344. package/codeyam-cli/src/webserver/build/client/assets/api.editor-refresh-l0sNRNKZ.js +1 -0
  345. package/codeyam-cli/src/webserver/build/client/assets/api.editor-register-scenario-l0sNRNKZ.js +1 -0
  346. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-coverage-l0sNRNKZ.js +1 -0
  347. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-data-l0sNRNKZ.js +1 -0
  348. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenario-image._-l0sNRNKZ.js +1 -0
  349. package/codeyam-cli/src/webserver/build/client/assets/api.editor-scenarios-l0sNRNKZ.js +1 -0
  350. package/codeyam-cli/src/webserver/build/client/assets/api.editor-switch-scenario-l0sNRNKZ.js +1 -0
  351. package/codeyam-cli/src/webserver/build/client/assets/api.editor-test-results-l0sNRNKZ.js +1 -0
  352. package/codeyam-cli/src/webserver/build/client/assets/{book-open-Bp5FLkd4.js → book-open-BYOypzCa.js} +2 -2
  353. package/codeyam-cli/src/webserver/build/client/assets/{chevron-down-DQJA9f4o.js → chevron-down-C_Pmso5S.js} +2 -2
  354. package/codeyam-cli/src/webserver/build/client/assets/{chunk-JZWAC4HX-7VptmeIr.js → chunk-JZWAC4HX-C4pqxYJB.js} +1 -1
  355. package/codeyam-cli/src/webserver/build/client/assets/{circle-check-B6C4LY9o.js → circle-check-BVMi9VA5.js} +2 -2
  356. package/codeyam-cli/src/webserver/build/client/assets/{copy-6nzYCu0G.js → copy-n2FB0_Sw.js} +3 -3
  357. package/codeyam-cli/src/webserver/build/client/assets/createLucideIcon-CC6AbExI.js +41 -0
  358. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-BsDh6TSF.js +1 -0
  359. package/codeyam-cli/src/webserver/build/client/assets/editor-PBc_6L9R.js +10 -0
  360. package/codeyam-cli/src/webserver/build/client/assets/editorPreview-4FzHlcNn.js +41 -0
  361. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha._-C6PQhwY5.js → entity._sha._-BsDXNp45.js} +9 -9
  362. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.dev-BgAqUtTZ.js +6 -0
  363. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-Bmshgrij.js +6 -0
  364. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-p9hhkjJM.js +6 -0
  365. package/codeyam-cli/src/webserver/build/client/assets/{entity._sha_.edit._scenarioId-C7ysA4Jq.js → entity._sha_.edit._scenarioId-BMvVHNXU.js} +2 -2
  366. package/codeyam-cli/src/webserver/build/client/assets/{entry.client-CU6EUArK.js → entry.client-DTvKq3TY.js} +1 -1
  367. package/codeyam-cli/src/webserver/build/client/assets/{fileTableUtils-EWpfFU4X.js → fileTableUtils-cPo8LiG3.js} +1 -1
  368. package/codeyam-cli/src/webserver/build/client/assets/{files-CrxAoWIL.js → files-BZrlFE1F.js} +1 -1
  369. package/codeyam-cli/src/webserver/build/client/assets/git-DdZcvjGh.js +1 -0
  370. package/codeyam-cli/src/webserver/build/client/assets/globals-B8vTTNy2.css +1 -0
  371. package/codeyam-cli/src/webserver/build/client/assets/{index-7-1FmlHo.js → index-10oVnAAH.js} +1 -1
  372. package/codeyam-cli/src/webserver/build/client/assets/{index-DuYcwYp_.js → index-BcvgDzbZ.js} +1 -1
  373. package/codeyam-cli/src/webserver/build/client/assets/index-yHOVb4rc.js +15 -0
  374. package/codeyam-cli/src/webserver/build/client/assets/{labs-CPPVOSWB.js → labs-Zk7ryIM1.js} +1 -1
  375. package/codeyam-cli/src/webserver/build/client/assets/{loader-circle-BnDcD54R.js → loader-circle-DaAZ_H2w.js} +2 -2
  376. package/codeyam-cli/src/webserver/build/client/assets/manifest-65850841.js +1 -0
  377. package/codeyam-cli/src/webserver/build/client/assets/memory-9gnxSZlb.js +101 -0
  378. package/codeyam-cli/src/webserver/build/client/assets/{pause-DhQX2g22.js → pause-f5-1lKBt.js} +3 -3
  379. package/codeyam-cli/src/webserver/build/client/assets/root-BwX8YgFb.js +67 -0
  380. package/codeyam-cli/src/webserver/build/client/assets/{search-DborVoKD.js → search-Di64LWVb.js} +2 -2
  381. package/codeyam-cli/src/webserver/build/client/assets/{settings-BWunYSXt.js → settings-0OrEMU6J.js} +1 -1
  382. package/codeyam-cli/src/webserver/build/client/assets/{simulations-BtrtCYJg.js → simulations-DWT-CvLy.js} +1 -1
  383. package/codeyam-cli/src/webserver/build/client/assets/{terminal-Bs4NC-VZ.js → terminal-Br7MOqts.js} +3 -3
  384. package/codeyam-cli/src/webserver/build/client/assets/{triangle-alert-DTf3Jojp.js → triangle-alert-BLdiCuG-.js} +2 -2
  385. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-BE43Hjti.js +1 -0
  386. package/codeyam-cli/src/webserver/build/client/assets/useLastLogLine-C14nCb1q.js +2 -0
  387. package/codeyam-cli/src/webserver/build/client/assets/{useReportContext-BsQb6rFd.js → useReportContext-O-jkvSPx.js} +1 -1
  388. package/codeyam-cli/src/webserver/build/client/assets/{useToast-BOur3mUv.js → useToast-9FIWuYfK.js} +1 -1
  389. package/codeyam-cli/src/webserver/build/client/assets/xterm-BqvuqXEL.js +27 -0
  390. package/codeyam-cli/src/webserver/build/server/assets/index-DEEQf4pi.js +1 -0
  391. package/codeyam-cli/src/webserver/build/server/assets/init-CkWmyFY2.js +10 -0
  392. package/codeyam-cli/src/webserver/build/server/assets/server-build-BHi-9O8W.js +439 -0
  393. package/codeyam-cli/src/webserver/build/server/index.js +1 -1
  394. package/codeyam-cli/src/webserver/build-info.json +5 -5
  395. package/codeyam-cli/src/webserver/devServer.js +39 -5
  396. package/codeyam-cli/src/webserver/devServer.js.map +1 -1
  397. package/codeyam-cli/src/webserver/editorProxy.js +877 -0
  398. package/codeyam-cli/src/webserver/editorProxy.js.map +1 -0
  399. package/codeyam-cli/src/webserver/scripts/codeyam-preload.mjs +414 -0
  400. package/codeyam-cli/src/webserver/scripts/journalCapture.ts +230 -0
  401. package/codeyam-cli/src/webserver/server.js +258 -1
  402. package/codeyam-cli/src/webserver/server.js.map +1 -1
  403. package/codeyam-cli/src/webserver/terminalServer.js +726 -0
  404. package/codeyam-cli/src/webserver/terminalServer.js.map +1 -0
  405. package/codeyam-cli/templates/chrome-extension-react/EXTENSION_SETUP.md +75 -0
  406. package/codeyam-cli/templates/chrome-extension-react/README.md +46 -0
  407. package/codeyam-cli/templates/chrome-extension-react/gitignore +15 -0
  408. package/codeyam-cli/templates/chrome-extension-react/index.html +12 -0
  409. package/codeyam-cli/templates/chrome-extension-react/package.json +27 -0
  410. package/codeyam-cli/templates/chrome-extension-react/popup.html +12 -0
  411. package/codeyam-cli/templates/chrome-extension-react/public/manifest.json +15 -0
  412. package/codeyam-cli/templates/chrome-extension-react/src/background/service-worker.ts +7 -0
  413. package/codeyam-cli/templates/chrome-extension-react/src/globals.css +6 -0
  414. package/codeyam-cli/templates/chrome-extension-react/src/lib/storage.ts +37 -0
  415. package/codeyam-cli/templates/chrome-extension-react/src/popup/App.tsx +12 -0
  416. package/codeyam-cli/templates/chrome-extension-react/src/popup/main.tsx +10 -0
  417. package/codeyam-cli/templates/chrome-extension-react/tsconfig.json +24 -0
  418. package/codeyam-cli/templates/chrome-extension-react/vite.config.ts +41 -0
  419. package/codeyam-cli/templates/codeyam-editor-claude.md +147 -0
  420. package/codeyam-cli/templates/editor-step-hook.py +236 -0
  421. package/codeyam-cli/templates/expo-react-native/MOBILE_SETUP.md +89 -0
  422. package/codeyam-cli/templates/expo-react-native/README.md +41 -0
  423. package/codeyam-cli/templates/expo-react-native/app/(tabs)/_layout.tsx +33 -0
  424. package/codeyam-cli/templates/expo-react-native/app/(tabs)/index.tsx +12 -0
  425. package/codeyam-cli/templates/expo-react-native/app/(tabs)/settings.tsx +12 -0
  426. package/codeyam-cli/templates/expo-react-native/app/_layout.tsx +12 -0
  427. package/codeyam-cli/templates/expo-react-native/app.json +18 -0
  428. package/codeyam-cli/templates/expo-react-native/babel.config.js +9 -0
  429. package/codeyam-cli/templates/expo-react-native/gitignore +12 -0
  430. package/codeyam-cli/templates/expo-react-native/global.css +3 -0
  431. package/codeyam-cli/templates/expo-react-native/lib/storage.ts +32 -0
  432. package/codeyam-cli/templates/expo-react-native/metro.config.js +6 -0
  433. package/codeyam-cli/templates/expo-react-native/nativewind-env.d.ts +1 -0
  434. package/codeyam-cli/templates/expo-react-native/package.json +38 -0
  435. package/codeyam-cli/templates/expo-react-native/tailwind.config.js +10 -0
  436. package/codeyam-cli/templates/expo-react-native/tsconfig.json +10 -0
  437. package/codeyam-cli/templates/isolation-route/next-app.tsx.template +80 -0
  438. package/codeyam-cli/templates/isolation-route/next-pages.tsx.template +79 -0
  439. package/codeyam-cli/templates/isolation-route/vite-react.tsx.template +78 -0
  440. package/codeyam-cli/templates/msw/browser-setup.ts.template +47 -0
  441. package/codeyam-cli/templates/msw/handler-router.ts.template +47 -0
  442. package/codeyam-cli/templates/msw/server-setup.ts.template +52 -0
  443. package/codeyam-cli/templates/nextjs-prisma-sqlite/AUTH_PATTERNS.md +308 -0
  444. package/codeyam-cli/templates/nextjs-prisma-sqlite/AUTH_UPGRADE.md +304 -0
  445. package/codeyam-cli/templates/nextjs-prisma-sqlite/DATABASE.md +126 -0
  446. package/codeyam-cli/templates/nextjs-prisma-sqlite/FEATURE_PATTERNS.md +37 -0
  447. package/codeyam-cli/templates/nextjs-prisma-sqlite/README.md +53 -0
  448. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/api/todos/route.ts +17 -0
  449. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/codeyam-isolate/layout.tsx +12 -0
  450. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/globals.css +26 -0
  451. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/layout.tsx +34 -0
  452. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/lib/prisma.ts +24 -0
  453. package/codeyam-cli/templates/nextjs-prisma-sqlite/app/page.tsx +10 -0
  454. package/codeyam-cli/templates/nextjs-prisma-sqlite/env +4 -0
  455. package/codeyam-cli/templates/nextjs-prisma-sqlite/eslint.config.mjs +11 -0
  456. package/codeyam-cli/templates/nextjs-prisma-sqlite/gitignore +64 -0
  457. package/codeyam-cli/templates/nextjs-prisma-sqlite/next.config.ts +14 -0
  458. package/codeyam-cli/templates/nextjs-prisma-sqlite/package.json +39 -0
  459. package/codeyam-cli/templates/nextjs-prisma-sqlite/postcss.config.mjs +7 -0
  460. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma/schema.prisma +27 -0
  461. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma/seed.ts +40 -0
  462. package/codeyam-cli/templates/nextjs-prisma-sqlite/prisma.config.ts +12 -0
  463. package/codeyam-cli/templates/nextjs-prisma-sqlite/seed-adapter.ts +92 -0
  464. package/codeyam-cli/templates/nextjs-prisma-sqlite/tsconfig.json +34 -0
  465. package/codeyam-cli/templates/nextjs-prisma-sqlite/vitest.config.ts +13 -0
  466. package/codeyam-cli/templates/nextjs-prisma-supabase/README.md +52 -0
  467. package/codeyam-cli/templates/nextjs-prisma-supabase/SUPABASE_SETUP.md +104 -0
  468. package/codeyam-cli/templates/nextjs-prisma-supabase/app/api/todos/route.ts +17 -0
  469. package/codeyam-cli/templates/nextjs-prisma-supabase/app/globals.css +26 -0
  470. package/codeyam-cli/templates/nextjs-prisma-supabase/app/layout.tsx +34 -0
  471. package/codeyam-cli/templates/nextjs-prisma-supabase/app/lib/prisma.ts +20 -0
  472. package/codeyam-cli/templates/nextjs-prisma-supabase/app/lib/supabase.ts +12 -0
  473. package/codeyam-cli/templates/nextjs-prisma-supabase/app/page.tsx +10 -0
  474. package/codeyam-cli/templates/nextjs-prisma-supabase/env +9 -0
  475. package/codeyam-cli/templates/nextjs-prisma-supabase/eslint.config.mjs +11 -0
  476. package/codeyam-cli/templates/nextjs-prisma-supabase/gitignore +40 -0
  477. package/codeyam-cli/templates/nextjs-prisma-supabase/next.config.ts +11 -0
  478. package/codeyam-cli/templates/nextjs-prisma-supabase/package.json +37 -0
  479. package/codeyam-cli/templates/nextjs-prisma-supabase/postcss.config.mjs +7 -0
  480. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma/schema.prisma +27 -0
  481. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma/seed.ts +39 -0
  482. package/codeyam-cli/templates/nextjs-prisma-supabase/prisma.config.ts +12 -0
  483. package/codeyam-cli/templates/nextjs-prisma-supabase/tsconfig.json +34 -0
  484. package/codeyam-cli/templates/skills/codeyam-dev-mode/SKILL.md +237 -0
  485. package/codeyam-cli/templates/skills/codeyam-editor/SKILL.md +148 -0
  486. package/codeyam-cli/templates/{codeyam-memory.md → skills/codeyam-memory/SKILL.md} +215 -0
  487. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/deprecated-prompt.md +100 -0
  488. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/detect-deprecated-patterns.mjs +139 -0
  489. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/find-exports.mjs +52 -0
  490. package/codeyam-cli/templates/skills/codeyam-memory/scripts/holistic-analysis/misleading-api-prompt.md +117 -0
  491. package/codeyam-cli/templates/skills/codeyam-memory/scripts/lib/read-json-field.mjs +61 -0
  492. package/codeyam-cli/templates/skills/codeyam-memory/scripts/lib/ripgrep-fallback.mjs +155 -0
  493. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/analyze-prompt.md +46 -0
  494. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/cleanup.mjs +13 -0
  495. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/filter-session.mjs +95 -0
  496. package/codeyam-cli/templates/skills/codeyam-memory/scripts/session-mining/preprocess.mjs +160 -0
  497. package/package.json +17 -10
  498. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js +22 -4
  499. package/packages/ai/src/lib/astScopes/astScopeAnalyzer.js.map +1 -1
  500. package/packages/ai/src/lib/completionCall.js +10 -2
  501. package/packages/ai/src/lib/completionCall.js.map +1 -1
  502. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js +21 -0
  503. package/packages/ai/src/lib/dataStructure/ScopeDataStructure.js.map +1 -1
  504. package/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.js +54 -0
  505. package/packages/ai/src/lib/dataStructure/helpers/coercePrimitivesToArraysBySchema.js.map +1 -0
  506. package/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.js +34 -0
  507. package/packages/ai/src/lib/dataStructure/helpers/stripNullableMarkers.js.map +1 -0
  508. package/packages/ai/src/lib/generateEntityScenarioData.js +57 -2
  509. package/packages/ai/src/lib/generateEntityScenarioData.js.map +1 -1
  510. package/packages/ai/src/lib/generateExecutionFlows.js +0 -11
  511. package/packages/ai/src/lib/generateExecutionFlows.js.map +1 -1
  512. package/packages/analyze/src/lib/ProjectAnalyzer.js +13 -4
  513. package/packages/analyze/src/lib/ProjectAnalyzer.js.map +1 -1
  514. package/packages/analyze/src/lib/asts/index.js +4 -2
  515. package/packages/analyze/src/lib/asts/index.js.map +1 -1
  516. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js +8 -1
  517. package/packages/analyze/src/lib/files/analyze/analyzeEntities.js.map +1 -1
  518. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js +0 -5
  519. package/packages/analyze/src/lib/files/analyze/dependencyResolver.js.map +1 -1
  520. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js +9 -0
  521. package/packages/analyze/src/lib/files/analyze/findOrCreateEntity.js.map +1 -1
  522. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js +54 -27
  523. package/packages/analyze/src/lib/files/scenarios/TransformationTracer.js.map +1 -1
  524. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js +65 -0
  525. package/packages/analyze/src/lib/files/scenarios/generateDataStructure.js.map +1 -1
  526. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js +0 -40
  527. package/packages/analyze/src/lib/files/scenarios/generateExecutionFlows.js.map +1 -1
  528. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js +18 -4
  529. package/packages/analyze/src/lib/files/scenarios/mergeInDependentDataStructure.js.map +1 -1
  530. package/packages/database/index.js +1 -0
  531. package/packages/database/index.js.map +1 -1
  532. package/packages/database/src/lib/kysely/db.js +5 -0
  533. package/packages/database/src/lib/kysely/db.js.map +1 -1
  534. package/packages/database/src/lib/kysely/tables/editorScenariosTable.js +76 -0
  535. package/packages/database/src/lib/kysely/tables/editorScenariosTable.js.map +1 -0
  536. package/packages/database/src/lib/loadCommits.js +23 -13
  537. package/packages/database/src/lib/loadCommits.js.map +1 -1
  538. package/packages/database/src/lib/loadEntities.js +0 -6
  539. package/packages/database/src/lib/loadEntities.js.map +1 -1
  540. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js +1 -4
  541. package/packages/database/src/lib/loadReadyToBeCapturedAnalyses.js.map +1 -1
  542. package/packages/database/src/lib/updateCommitMetadata.js +76 -90
  543. package/packages/database/src/lib/updateCommitMetadata.js.map +1 -1
  544. package/packages/database/src/lib/updateFreshAnalysisStatus.js +41 -30
  545. package/packages/database/src/lib/updateFreshAnalysisStatus.js.map +1 -1
  546. package/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.js +68 -57
  547. package/packages/database/src/lib/updateFreshAnalysisStatusWithScenarios.js.map +1 -1
  548. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js +29 -1
  549. package/packages/generate/src/lib/componentScenarioPage/generateScenarioClientWrapper.js.map +1 -1
  550. package/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js +33 -5
  551. package/packages/generate/src/lib/componentScenarioPage/getIFrameMessageListenerCode.js.map +1 -1
  552. package/packages/types/src/enums/ProjectFramework.js +2 -0
  553. package/packages/types/src/enums/ProjectFramework.js.map +1 -1
  554. package/scripts/npm-post-install.cjs +34 -0
  555. package/codeyam-cli/src/webserver/build/client/assets/InlineSpinner-C1rIyZdV.js +0 -34
  556. package/codeyam-cli/src/webserver/build/client/assets/createLucideIcon-D-QUFOwe.js +0 -21
  557. package/codeyam-cli/src/webserver/build/client/assets/dev.empty-DmzSmblj.js +0 -1
  558. package/codeyam-cli/src/webserver/build/client/assets/entity._sha.scenarios._scenarioId.fullscreen-DVTcUnur.js +0 -6
  559. package/codeyam-cli/src/webserver/build/client/assets/entity._sha_.create-scenario-BVgNO76F.js +0 -6
  560. package/codeyam-cli/src/webserver/build/client/assets/git-BldHtKeW.js +0 -15
  561. package/codeyam-cli/src/webserver/build/client/assets/globals-CLmFdUae.css +0 -1
  562. package/codeyam-cli/src/webserver/build/client/assets/manifest-717e346a.js +0 -1
  563. package/codeyam-cli/src/webserver/build/client/assets/memory-0wMU4KXe.js +0 -93
  564. package/codeyam-cli/src/webserver/build/client/assets/root-DqfSDjyQ.js +0 -62
  565. package/codeyam-cli/src/webserver/build/client/assets/useCustomSizes-D_bDZyDU.js +0 -1
  566. package/codeyam-cli/src/webserver/build/client/assets/useLastLogLine-DZp6rrQD.js +0 -2
  567. package/codeyam-cli/src/webserver/build/server/assets/index-B8jmgmn2.js +0 -1
  568. package/codeyam-cli/src/webserver/build/server/assets/server-build-9OU4lmvL.js +0 -285
  569. package/scripts/finalize-analyzer.cjs +0 -13
  570. /package/codeyam-cli/templates/{codeyam-diagnose.md → commands/codeyam-diagnose.md} +0 -0
  571. /package/codeyam-cli/templates/{codeyam-debug.md → skills/codeyam-debug/SKILL.md} +0 -0
  572. /package/codeyam-cli/templates/{codeyam-new-rule.md → skills/codeyam-new-rule/SKILL.md} +0 -0
  573. /package/codeyam-cli/templates/{codeyam-setup.md → skills/codeyam-setup/SKILL.md} +0 -0
  574. /package/codeyam-cli/templates/{codeyam-sim.md → skills/codeyam-sim/SKILL.md} +0 -0
  575. /package/codeyam-cli/templates/{codeyam-test.md → skills/codeyam-test/SKILL.md} +0 -0
  576. /package/codeyam-cli/templates/{codeyam-verify.md → skills/codeyam-verify/SKILL.md} +0 -0
@@ -0,0 +1,112 @@
1
+ /**
2
+ * Shared scenario switching logic.
3
+ *
4
+ * Both `/api/dev-mode-preview` (Express, server.ts) and
5
+ * `/api/editor-switch-scenario` (React Router action) need to switch
6
+ * the active scenario. This module consolidates that logic so both
7
+ * code paths handle seed-based scenarios correctly.
8
+ */
9
+ import fs from 'fs';
10
+ import path from 'path';
11
+ import { runSeedAdapter, detectSeedAdapter } from "./editorSeedAdapter.js";
12
+ /**
13
+ * Track in-flight seed operations to deduplicate concurrent requests
14
+ * for the same scenario.
15
+ */
16
+ let activeSeedOperation = null;
17
+ /**
18
+ * Switch the active editor scenario.
19
+ *
20
+ * 1. Resolves the scenario type from the data file if not provided
21
+ * 2. Writes `active-scenario.json` (including `type`)
22
+ * 3. Runs the seed adapter for application/user scenarios
23
+ * 4. Returns the result (caller is responsible for cache invalidation and refresh)
24
+ */
25
+ export async function switchActiveScenario(params) {
26
+ const { scenarioId, projectRoot } = params;
27
+ const codeyamDir = path.join(projectRoot, '.codeyam');
28
+ const scenariosDir = path.join(codeyamDir, 'editor-scenarios');
29
+ // Resolve slug from data file if not provided
30
+ let effectiveSlug = params.scenarioSlug || null;
31
+ if (!effectiveSlug) {
32
+ try {
33
+ const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
34
+ if (fs.existsSync(dataFile)) {
35
+ const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
36
+ effectiveSlug = data.name || scenarioId;
37
+ }
38
+ else {
39
+ effectiveSlug = scenarioId;
40
+ }
41
+ }
42
+ catch {
43
+ effectiveSlug = scenarioId;
44
+ }
45
+ }
46
+ // Resolve type: prefer explicit param, fall back to data file
47
+ let effectiveType = params.scenarioType || null;
48
+ if (!effectiveType) {
49
+ try {
50
+ const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
51
+ if (fs.existsSync(dataFile)) {
52
+ const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
53
+ effectiveType = data.type || null;
54
+ }
55
+ }
56
+ catch {
57
+ // Non-fatal
58
+ }
59
+ }
60
+ // Write active-scenario.json — MUST include type so proxy is type-aware
61
+ const activeScenarioPath = path.join(codeyamDir, 'active-scenario.json');
62
+ fs.mkdirSync(codeyamDir, { recursive: true });
63
+ fs.writeFileSync(activeScenarioPath, JSON.stringify({
64
+ scenarioSlug: effectiveSlug,
65
+ scenarioName: params.scenarioName || effectiveSlug,
66
+ scenarioId,
67
+ type: effectiveType,
68
+ dataFile: `.codeyam/editor-scenarios/${scenarioId}.json`,
69
+ switchedAt: new Date().toISOString(),
70
+ }, null, 2));
71
+ // Run seed adapter for application/user scenarios
72
+ let seedResult = null;
73
+ const isSeedScenario = effectiveType === 'application' || effectiveType === 'user';
74
+ if (isSeedScenario) {
75
+ // Deduplicate concurrent seed requests for the same scenario
76
+ if (activeSeedOperation && activeSeedOperation.scenarioId === scenarioId) {
77
+ seedResult = await activeSeedOperation.promise;
78
+ }
79
+ else {
80
+ const adapterPath = detectSeedAdapter(projectRoot);
81
+ const seedDataPath = path.join(scenariosDir, `${scenarioId}.seed.json`);
82
+ if (adapterPath && fs.existsSync(seedDataPath)) {
83
+ const seedPromise = runSeedAdapter(adapterPath, seedDataPath).then((result) => ({
84
+ success: result.success,
85
+ error: result.error,
86
+ }));
87
+ activeSeedOperation = { scenarioId, promise: seedPromise };
88
+ try {
89
+ seedResult = await seedPromise;
90
+ }
91
+ finally {
92
+ if (activeSeedOperation &&
93
+ activeSeedOperation.scenarioId === scenarioId) {
94
+ activeSeedOperation = null;
95
+ }
96
+ }
97
+ }
98
+ else if (!adapterPath) {
99
+ seedResult = { success: false, error: 'No seed adapter found' };
100
+ }
101
+ }
102
+ }
103
+ return {
104
+ success: true,
105
+ scenarioSlug: effectiveSlug,
106
+ scenarioId,
107
+ type: effectiveType,
108
+ seeded: isSeedScenario,
109
+ ...(seedResult ? { seedResult } : {}),
110
+ };
111
+ }
112
+ //# sourceMappingURL=editorScenarioSwitch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editorScenarioSwitch.js","sourceRoot":"","sources":["../../../../src/utils/editorScenarioSwitch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,332 @@
1
+ /**
2
+ * Shared scenario utilities used across editor routes and components.
3
+ *
4
+ * Extracted from inline logic in editor.tsx, api.editor-journal-entry.ts,
5
+ * and api.editor-register-scenario.ts.
6
+ */
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ /**
10
+ * Generic Map-based deduplication that keeps the last item for each key.
11
+ * Items are iterated in order, so later entries overwrite earlier ones.
12
+ * Map preserves insertion order of first appearance.
13
+ */
14
+ export function deduplicateByName(items, keyFn) {
15
+ const byKey = new Map();
16
+ for (const item of items) {
17
+ byKey.set(keyFn(item), item);
18
+ }
19
+ return [...byKey.values()];
20
+ }
21
+ /**
22
+ * Convert a scenario name to a URL-safe slug.
23
+ * Replaces any run of non-alphanumeric, non-underscore characters with a single underscore.
24
+ */
25
+ export function generateScenarioSlug(name) {
26
+ return name.replace(/[^a-zA-Z0-9_]+/g, '_');
27
+ }
28
+ /**
29
+ * Convert an ISO 8601 timestamp (e.g. "2026-02-28T19:00:00.000Z") to
30
+ * SQLite-compatible format (e.g. "2026-02-28 19:00:00").
31
+ *
32
+ * SQLite's CURRENT_TIMESTAMP uses space-separated "YYYY-MM-DD HH:MM:SS" format,
33
+ * so we need this conversion for date comparisons.
34
+ */
35
+ export function convertIsoToSqliteTimestamp(iso) {
36
+ return iso.replace('T', ' ').replace(/\.\d{3}Z$/, '');
37
+ }
38
+ /**
39
+ * Properties in config.json that are user-configured and must survive a re-init.
40
+ * Auto-detected properties (projectSlug, packageManager, webapps, createdAt, etc.)
41
+ * are intentionally NOT preserved — init should re-detect them.
42
+ */
43
+ const PRESERVED_CONFIG_KEYS = [
44
+ 'defaultScreenSize',
45
+ 'screenSizes',
46
+ 'projectTitle',
47
+ 'projectDescription',
48
+ ];
49
+ /**
50
+ * Read user-configured properties from an existing config.json that should be
51
+ * preserved when `codeyam init --force` overwrites the file.
52
+ *
53
+ * Returns only the properties listed in PRESERVED_CONFIG_KEYS.
54
+ * Returns an empty object if the file doesn't exist or can't be parsed.
55
+ */
56
+ export function readPreservedConfigProperties(configPath) {
57
+ try {
58
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
59
+ const preserved = {};
60
+ for (const key of PRESERVED_CONFIG_KEYS) {
61
+ if (config[key] !== undefined) {
62
+ preserved[key] = config[key];
63
+ }
64
+ }
65
+ return preserved;
66
+ }
67
+ catch {
68
+ return {};
69
+ }
70
+ }
71
+ /**
72
+ * Validate that a step transition is allowed.
73
+ *
74
+ * Rules:
75
+ * - Step 1 is always allowed (starts a new feature).
76
+ * - Steps 2–13 require the current state step to be at least (requestedStep - 1),
77
+ * i.e. you can advance one step at a time or re-run the current step, but
78
+ * you cannot skip ahead.
79
+ *
80
+ * Returns null if valid, or an error message string if invalid.
81
+ */
82
+ export function validateStepTransition(requestedStep, currentStep) {
83
+ // Step 1 always allowed — it starts or restarts a feature
84
+ if (requestedStep === 1)
85
+ return null;
86
+ // No state at all — must start from step 1
87
+ if (currentStep === null) {
88
+ return `Cannot jump to step ${requestedStep} — no feature in progress. Run step 1 first.`;
89
+ }
90
+ // Allow re-running the current step or advancing to the next step
91
+ if (requestedStep <= currentStep + 1)
92
+ return null;
93
+ return `Cannot jump from step ${currentStep} to step ${requestedStep}. Complete step ${currentStep + 1} first.`;
94
+ }
95
+ /**
96
+ * Resolve which URL to use for Playwright screenshot capture.
97
+ *
98
+ * Priority:
99
+ * 1. Path-based URL + proxy → combine (component isolation with API interception)
100
+ * 2. Full URL → use directly (legacy)
101
+ * 3. No URL → proxy root or dev server root (page scenarios)
102
+ */
103
+ /**
104
+ * Resolve the navigation path for preview refresh.
105
+ * Priority: explicit path > scenario URL from DB > undefined (plain refresh).
106
+ */
107
+ export function resolvePreviewNavPath(explicitPath, scenarioUrl) {
108
+ if (explicitPath)
109
+ return explicitPath;
110
+ if (scenarioUrl)
111
+ return scenarioUrl;
112
+ return undefined;
113
+ }
114
+ /**
115
+ * Clear the editor step state file (for starting a new feature).
116
+ * This should NOT touch the user prompt file — the prompt is captured
117
+ * by the hook before step 1 runs, so deleting it here would lose it.
118
+ */
119
+ export function clearEditorState(root) {
120
+ const statePath = path.join(root, '.codeyam', 'editor-step.json');
121
+ try {
122
+ fs.unlinkSync(statePath);
123
+ }
124
+ catch {
125
+ // File doesn't exist, that's fine
126
+ }
127
+ }
128
+ /**
129
+ * Clear the user prompt file so the hook can capture the next feature request.
130
+ * Call this after a feature is committed, not during step 1.
131
+ */
132
+ export function clearEditorUserPrompt(root) {
133
+ const promptPath = path.join(root, '.codeyam', 'editor-user-prompt.txt');
134
+ try {
135
+ fs.unlinkSync(promptPath);
136
+ }
137
+ catch {
138
+ // File doesn't exist, that's fine
139
+ }
140
+ }
141
+ export function determineCaptureUrl(url, proxyUrl, devServerUrl) {
142
+ const isPath = url && url.startsWith('/');
143
+ if (isPath && proxyUrl) {
144
+ return `${proxyUrl}${url}`;
145
+ }
146
+ else if (url && !isPath) {
147
+ return url;
148
+ }
149
+ else {
150
+ return proxyUrl || devServerUrl || null;
151
+ }
152
+ }
153
+ /**
154
+ * Read the project's default screen size from .codeyam/config.json.
155
+ * Returns { width, height } or null if not configured.
156
+ */
157
+ export function readDefaultScreenSize(codeyamRoot) {
158
+ try {
159
+ const configPath = path.join(codeyamRoot, '.codeyam', 'config.json');
160
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
161
+ if (config.defaultScreenSize?.width && config.defaultScreenSize?.height) {
162
+ return {
163
+ width: config.defaultScreenSize.width,
164
+ height: config.defaultScreenSize.height,
165
+ };
166
+ }
167
+ }
168
+ catch {
169
+ // Non-fatal
170
+ }
171
+ return null;
172
+ }
173
+ /**
174
+ * Read named screen sizes from .codeyam/config.json.
175
+ * Returns a map of name → { width, height }, or empty object if not configured.
176
+ *
177
+ * Config format:
178
+ * "screenSizes": {
179
+ * "Desktop": { "width": 1440, "height": 900 },
180
+ * "Mobile": { "width": 375, "height": 667 }
181
+ * }
182
+ */
183
+ export function readScreenSizes(codeyamRoot) {
184
+ try {
185
+ const configPath = path.join(codeyamRoot, '.codeyam', 'config.json');
186
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
187
+ if (config.screenSizes &&
188
+ typeof config.screenSizes === 'object' &&
189
+ !Array.isArray(config.screenSizes)) {
190
+ return config.screenSizes;
191
+ }
192
+ }
193
+ catch {
194
+ // Non-fatal
195
+ }
196
+ return {};
197
+ }
198
+ /**
199
+ * Resolve the viewport dimensions for a scenario capture.
200
+ * Priority: explicit body values > project default > hardcoded fallback (1280×720).
201
+ */
202
+ export function resolveScenarioViewport(params) {
203
+ return {
204
+ width: params.bodyWidth || params.projectDefault?.width || 1280,
205
+ height: params.bodyHeight || params.projectDefault?.height || 720,
206
+ };
207
+ }
208
+ /**
209
+ * Resolve viewport dimensions by reading the project config.
210
+ *
211
+ * Priority chain:
212
+ * 1. Explicit bodyWidth/bodyHeight (highest)
213
+ * 2. Named dimension → lookup in config screenSizes map
214
+ * 3. Project defaultScreenSize from config
215
+ * 4. 1280×720 hardcoded fallback (lowest)
216
+ *
217
+ * Use this in any capture endpoint that needs viewport resolution.
218
+ */
219
+ export function resolveViewportWithProjectDefault(params) {
220
+ // Look up named dimension from screenSizes if provided
221
+ let dimensionSize = null;
222
+ if (params.dimension) {
223
+ const screenSizes = readScreenSizes(params.codeyamRoot);
224
+ const entry = screenSizes[params.dimension];
225
+ if (entry?.width && entry?.height) {
226
+ dimensionSize = { width: entry.width, height: entry.height };
227
+ }
228
+ }
229
+ const projectDefault = dimensionSize || readDefaultScreenSize(params.codeyamRoot);
230
+ return resolveScenarioViewport({
231
+ bodyWidth: params.bodyWidth,
232
+ bodyHeight: params.bodyHeight,
233
+ projectDefault,
234
+ });
235
+ }
236
+ /**
237
+ * Insert or update an editor scenario by name + project.
238
+ *
239
+ * When a scenario with the same name already exists for the project:
240
+ * - Reuses the most recent row's ID (so data files at that path get overwritten naturally)
241
+ * - Updates the row with the new values
242
+ * - Deletes any additional duplicate rows that accumulated from past always-insert behavior
243
+ *
244
+ * When no existing scenario matches: inserts a new row with a fresh UUID.
245
+ */
246
+ export async function upsertEditorScenario(db, params) {
247
+ // Find all existing scenarios with the same name + project
248
+ const existing = await db
249
+ .selectFrom('editor_scenarios')
250
+ .selectAll()
251
+ .where('name', '=', params.name)
252
+ .where('project_id', '=', params.projectId)
253
+ .orderBy('created_at', 'desc')
254
+ .execute();
255
+ if (existing.length > 0) {
256
+ // Reuse the most recent row's ID
257
+ const latest = existing[0];
258
+ const scenarioId = latest.id;
259
+ // Update the existing row with new values
260
+ await db
261
+ .updateTable('editor_scenarios')
262
+ .set({
263
+ description: params.description,
264
+ component_name: params.componentName,
265
+ component_path: params.componentPath,
266
+ url: params.url,
267
+ type: params.type,
268
+ viewport_width: params.viewportWidth,
269
+ viewport_height: params.viewportHeight,
270
+ dimension: params.dimension,
271
+ updated_at: new Date()
272
+ .toISOString()
273
+ .replace('T', ' ')
274
+ .replace(/\.\d{3}Z$/, ''),
275
+ })
276
+ .where('id', '=', scenarioId)
277
+ .execute();
278
+ // Delete duplicate rows (all except the latest)
279
+ const duplicateIds = existing.slice(1).map((r) => r.id);
280
+ if (duplicateIds.length > 0) {
281
+ await db
282
+ .deleteFrom('editor_scenarios')
283
+ .where('id', 'in', duplicateIds)
284
+ .execute();
285
+ }
286
+ return { scenarioId, isNew: false, cleanedUpIds: duplicateIds };
287
+ }
288
+ // No existing scenario — insert new
289
+ // Use globalThis.crypto (Web Crypto API) to avoid pulling Node's crypto
290
+ // module into the Vite client bundle (this file is also imported client-side
291
+ // for deduplicateByName).
292
+ const scenarioId = globalThis.crypto.randomUUID();
293
+ await db
294
+ .insertInto('editor_scenarios')
295
+ .values({
296
+ id: scenarioId,
297
+ project_id: params.projectId,
298
+ name: params.name,
299
+ description: params.description,
300
+ component_name: params.componentName,
301
+ component_path: params.componentPath,
302
+ url: params.url,
303
+ type: params.type,
304
+ viewport_width: params.viewportWidth,
305
+ viewport_height: params.viewportHeight,
306
+ dimension: params.dimension,
307
+ })
308
+ .execute();
309
+ return { scenarioId, isNew: true, cleanedUpIds: [] };
310
+ }
311
+ /**
312
+ * Delete data files (.json, .seed.json) and screenshots for a list of scenario IDs.
313
+ * Used to clean up orphaned files after deduplication.
314
+ */
315
+ export function cleanupScenarioFiles(codeyamRoot, scenarioIds) {
316
+ const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
317
+ for (const id of scenarioIds) {
318
+ for (const file of [
319
+ `${id}.json`,
320
+ `${id}.seed.json`,
321
+ path.join('screenshots', `${id}.png`),
322
+ ]) {
323
+ try {
324
+ fs.unlinkSync(path.join(scenariosDir, file));
325
+ }
326
+ catch {
327
+ // File doesn't exist, that's fine
328
+ }
329
+ }
330
+ }
331
+ }
332
+ //# sourceMappingURL=editorScenarios.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editorScenarios.js","sourceRoot":"","sources":["../../../../src/utils/editorScenarios.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,173 @@
1
+ /**
2
+ * Seed adapter runner for application/user scenarios.
3
+ *
4
+ * Runs the project's seed-adapter script to wipe and re-seed
5
+ * the dev database with scenario-specific data.
6
+ */
7
+ import { spawn } from 'child_process';
8
+ import * as fs from 'fs';
9
+ import * as path from 'path';
10
+ const DEFAULT_TIMEOUT_MS = 30000;
11
+ /**
12
+ * Run a seed adapter script, passing the seed data JSON file path as the first CLI arg.
13
+ *
14
+ * For .ts files, runs via `npx tsx`. For other files, runs directly.
15
+ * The cwd defaults to the project root (parent of `.codeyam/`) so the adapter
16
+ * can access node_modules, prisma/, etc.
17
+ */
18
+ export function runSeedAdapter(scriptPath, seedDataPath, options) {
19
+ const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
20
+ // Default cwd: go up from .codeyam/ to project root
21
+ const cwd = options?.cwd ??
22
+ (path.basename(path.dirname(scriptPath)) === '.codeyam'
23
+ ? path.dirname(path.dirname(scriptPath))
24
+ : path.dirname(scriptPath));
25
+ return new Promise((resolve) => {
26
+ const start = Date.now();
27
+ const isTsFile = scriptPath.endsWith('.ts');
28
+ const command = isTsFile ? 'npx' : scriptPath;
29
+ const args = isTsFile ? ['tsx', scriptPath, seedDataPath] : [seedDataPath];
30
+ const child = spawn(command, args, {
31
+ cwd,
32
+ env: { ...process.env },
33
+ });
34
+ let stdout = '';
35
+ let stderr = '';
36
+ let killed = false;
37
+ const timer = setTimeout(() => {
38
+ killed = true;
39
+ child.kill('SIGTERM');
40
+ }, timeoutMs);
41
+ child.stdout.on('data', (data) => {
42
+ stdout += data.toString();
43
+ });
44
+ child.stderr.on('data', (data) => {
45
+ stderr += data.toString();
46
+ });
47
+ child.on('close', (code) => {
48
+ clearTimeout(timer);
49
+ const durationMs = Date.now() - start;
50
+ if (killed) {
51
+ resolve({
52
+ success: false,
53
+ output: stdout,
54
+ error: `Seed adapter timeout after ${timeoutMs}ms`,
55
+ durationMs,
56
+ });
57
+ }
58
+ else if (code === 0) {
59
+ resolve({ success: true, output: stdout, durationMs });
60
+ }
61
+ else {
62
+ resolve({
63
+ success: false,
64
+ output: stdout,
65
+ error: stderr || `Seed adapter exited with code ${code}`,
66
+ durationMs,
67
+ });
68
+ }
69
+ });
70
+ child.on('error', (err) => {
71
+ clearTimeout(timer);
72
+ resolve({
73
+ success: false,
74
+ output: '',
75
+ error: err.message,
76
+ durationMs: Date.now() - start,
77
+ });
78
+ });
79
+ });
80
+ }
81
+ /**
82
+ * Extract just the seed data from a scenario JSON file and write it to a
83
+ * temporary file. The adapter receives clean seed data ({drinks: [...]})
84
+ * without the CodeYam envelope ({type, seed, externalApis}).
85
+ *
86
+ * Returns the path to the temp file (caller should clean up after use).
87
+ */
88
+ export function prepareSeedDataFile(scenarioFilePath) {
89
+ try {
90
+ const raw = fs.readFileSync(scenarioFilePath, 'utf-8');
91
+ const data = JSON.parse(raw);
92
+ // Extract seed data from envelope, or use as-is if no envelope
93
+ const seedData = data.seed || data;
94
+ const tempPath = scenarioFilePath.replace(/\.json$/, '.seed.json');
95
+ fs.writeFileSync(tempPath, JSON.stringify(seedData, null, 2));
96
+ return tempPath;
97
+ }
98
+ catch {
99
+ return null;
100
+ }
101
+ }
102
+ /**
103
+ * Clean up a temporary seed data file created by prepareSeedDataFile.
104
+ */
105
+ export function cleanupSeedDataFile(tempPath) {
106
+ try {
107
+ if (fs.existsSync(tempPath)) {
108
+ fs.unlinkSync(tempPath);
109
+ }
110
+ }
111
+ catch {
112
+ // Best effort
113
+ }
114
+ }
115
+ /**
116
+ * Detect a seed adapter script in the project's .codeyam directory.
117
+ * Returns the absolute path if found, null otherwise.
118
+ */
119
+ export function detectSeedAdapter(projectRoot) {
120
+ const candidates = ['seed-adapter.ts', 'seed-adapter.js'];
121
+ for (const filename of candidates) {
122
+ const fullPath = path.join(projectRoot, '.codeyam', filename);
123
+ try {
124
+ fs.accessSync(fullPath);
125
+ return fullPath;
126
+ }
127
+ catch {
128
+ // Try next
129
+ }
130
+ }
131
+ return null;
132
+ }
133
+ /**
134
+ * Validate that seed data has the expected structure:
135
+ * a non-empty object where every value is an array of objects (table rows).
136
+ */
137
+ export function validateSeedData(data) {
138
+ const errors = [];
139
+ const keys = Object.keys(data);
140
+ if (keys.length === 0) {
141
+ errors.push('Seed data must contain at least one table');
142
+ return { valid: false, errors };
143
+ }
144
+ for (const key of keys) {
145
+ const value = data[key];
146
+ if (!Array.isArray(value)) {
147
+ errors.push(`"${key}" must be an array of objects, got ${typeof value}`);
148
+ continue;
149
+ }
150
+ for (let i = 0; i < value.length; i++) {
151
+ if (typeof value[i] !== 'object' || value[i] === null) {
152
+ errors.push(`"${key}[${i}]" must be an object, got ${typeof value[i]}`);
153
+ }
154
+ }
155
+ }
156
+ return { valid: errors.length === 0, errors };
157
+ }
158
+ /**
159
+ * Merge base scenario seed data with an overlay (user scenario).
160
+ * Overlay tables replace base tables entirely (no row-level merge).
161
+ * Does not mutate inputs.
162
+ */
163
+ export function mergeSeedData(base, overlay) {
164
+ const result = {};
165
+ for (const [key, value] of Object.entries(base)) {
166
+ result[key] = JSON.parse(JSON.stringify(value));
167
+ }
168
+ for (const [key, value] of Object.entries(overlay)) {
169
+ result[key] = JSON.parse(JSON.stringify(value));
170
+ }
171
+ return result;
172
+ }
173
+ //# sourceMappingURL=editorSeedAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editorSeedAdapter.js","sourceRoot":"","sources":["../../../../src/utils/editorSeedAdapter.ts"],"names":[],"mappings":"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"}