collavre 0.24.0 → 0.25.0

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 (440) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +0 -1
  3. data/app/assets/stylesheets/collavre/comments_popup.css +165 -99
  4. data/app/assets/stylesheets/collavre/creatives.css +346 -37
  5. data/app/assets/stylesheets/collavre/desktop_setup.css +246 -0
  6. data/app/assets/stylesheets/collavre/gnb.css +64 -3
  7. data/app/assets/stylesheets/collavre/landing.css +108 -3
  8. data/app/assets/stylesheets/collavre/mention_menu.css +32 -0
  9. data/app/assets/stylesheets/collavre/popup.css +14 -0
  10. data/app/assets/stylesheets/collavre/print.css +0 -1
  11. data/app/assets/stylesheets/collavre/search_popup.css +1 -1
  12. data/app/assets/stylesheets/collavre/secret_fields.css +3 -0
  13. data/app/assets/stylesheets/collavre/workspace.css +307 -0
  14. data/app/channels/collavre/agent_channel.rb +14 -21
  15. data/app/channels/collavre/comments_presence_channel.rb +181 -21
  16. data/app/channels/collavre/inbox_badge_channel.rb +7 -1
  17. data/app/components/collavre/inbox/badge_component.rb +6 -13
  18. data/app/components/collavre/progress_filter_component.html.erb +2 -2
  19. data/app/components/collavre/progress_filter_component.rb +20 -0
  20. data/app/controllers/collavre/admin/settings_controller.rb +4 -1
  21. data/app/controllers/collavre/agent_connections_controller.rb +165 -0
  22. data/app/controllers/collavre/agent_gateways_controller.rb +132 -0
  23. data/app/controllers/collavre/agent_provisioning_controller.rb +79 -0
  24. data/app/controllers/collavre/api/v1/agents_controller.rb +45 -97
  25. data/app/controllers/collavre/application_controller.rb +13 -2
  26. data/app/controllers/collavre/comment_read_pointers_controller.rb +69 -40
  27. data/app/controllers/collavre/comments_controller.rb +45 -131
  28. data/app/controllers/collavre/concerns/shareable.rb +9 -3
  29. data/app/controllers/collavre/creatives_controller.rb +144 -11
  30. data/app/controllers/collavre/desktop_gateway_registrations_controller.rb +173 -0
  31. data/app/controllers/collavre/desktop_setup_controller.rb +119 -0
  32. data/app/controllers/collavre/desktop_sidecar_health_controller.rb +35 -0
  33. data/app/controllers/collavre/features_controller.rb +57 -0
  34. data/app/controllers/collavre/invites_controller.rb +12 -1
  35. data/app/controllers/collavre/llm_models_controller.rb +8 -0
  36. data/app/controllers/collavre/notices_controller.rb +20 -0
  37. data/app/controllers/collavre/tasks_controller.rb +40 -6
  38. data/app/controllers/collavre/topics_controller.rb +130 -53
  39. data/app/controllers/collavre/user_creative_preferences_controller.rb +214 -30
  40. data/app/controllers/concerns/collavre/comments/batch_operations.rb +15 -3
  41. data/app/controllers/concerns/collavre/comments/conversion.rb +1 -1
  42. data/app/controllers/concerns/collavre/users_controller/ai_user_management.rb +118 -8
  43. data/app/controllers/concerns/collavre/users_controller/profile_and_settings.rb +1 -15
  44. data/app/controllers/concerns/collavre/users_controller/registration.rb +2 -2
  45. data/app/errors/collavre/turn_deadline_error.rb +20 -0
  46. data/app/helpers/collavre/application_helper.rb +38 -0
  47. data/app/helpers/collavre/creatives_helper.rb +56 -22
  48. data/app/helpers/collavre/navigation_helper.rb +12 -0
  49. data/app/javascript/collavre.js +1 -2
  50. data/app/javascript/components/InlineLexicalEditor.jsx +30 -21
  51. data/app/javascript/components/__tests__/creative_tree_row_parent_id.test.js +32 -2
  52. data/app/javascript/components/__tests__/creative_tree_row_progress_toggle.test.js +185 -0
  53. data/app/javascript/components/creative_tree_row.js +62 -22
  54. data/app/javascript/controllers/__tests__/agent_connection_controller.test.js +195 -0
  55. data/app/javascript/controllers/__tests__/desktop_proxy_setup_controller.test.js +96 -0
  56. data/app/javascript/controllers/__tests__/index.test.js +42 -0
  57. data/app/javascript/controllers/__tests__/last_visited_creative_controller.test.js +103 -0
  58. data/app/javascript/controllers/__tests__/link_creative_controller.test.js +253 -2
  59. data/app/javascript/controllers/__tests__/progress_filter_controller.test.js +134 -0
  60. data/app/javascript/controllers/__tests__/search_popup_controller.test.js +310 -0
  61. data/app/javascript/controllers/__tests__/topic_list_controller.test.js +111 -0
  62. data/app/javascript/controllers/__tests__/workspace_tree_controller.test.js +1011 -0
  63. data/app/javascript/controllers/agent_connection_controller.js +357 -0
  64. data/app/javascript/controllers/agent_vendor_controller.js +23 -0
  65. data/app/javascript/controllers/comment_controller.js +3 -1
  66. data/app/javascript/controllers/comments/__tests__/feature_cards_controller.test.js +223 -0
  67. data/app/javascript/controllers/comments/__tests__/form_controller_default_placeholder.test.js +83 -0
  68. data/app/javascript/controllers/comments/__tests__/form_controller_draft.test.js +2069 -0
  69. data/app/javascript/controllers/comments/__tests__/form_controller_ime_send.test.js +324 -0
  70. data/app/javascript/controllers/comments/__tests__/form_controller_review.test.js +28 -2
  71. data/app/javascript/controllers/comments/__tests__/form_controller_search_submit.test.js +106 -0
  72. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft.test.js +134 -0
  73. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft_creative_switch.test.js +166 -0
  74. data/app/javascript/controllers/comments/__tests__/form_controller_stashed_draft_failure.test.js +183 -0
  75. data/app/javascript/controllers/comments/__tests__/list_controller_deep_link_topic.test.js +467 -0
  76. data/app/javascript/controllers/comments/__tests__/list_controller_docked.test.js +115 -0
  77. data/app/javascript/controllers/comments/__tests__/list_controller_prev_message.test.js +245 -0
  78. data/app/javascript/controllers/comments/__tests__/list_controller_read_pointer.test.js +276 -0
  79. data/app/javascript/controllers/comments/__tests__/list_controller_stream_archived.test.js +221 -0
  80. data/app/javascript/controllers/comments/__tests__/list_controller_stream_search.test.js +104 -0
  81. data/app/javascript/controllers/comments/__tests__/placeholder_controller.test.js +79 -0
  82. data/app/javascript/controllers/comments/__tests__/popup_controller.test.js +754 -1
  83. data/app/javascript/controllers/comments/__tests__/presence_controller.test.js +717 -15
  84. data/app/javascript/controllers/comments/__tests__/prev_message_navigator.test.js +129 -0
  85. data/app/javascript/controllers/comments/__tests__/topics_controller_action_errors.test.js +184 -0
  86. data/app/javascript/controllers/comments/__tests__/topics_controller_archived.test.js +879 -0
  87. data/app/javascript/controllers/comments/__tests__/topics_controller_creation_container.test.js +154 -0
  88. data/app/javascript/controllers/comments/__tests__/topics_controller_creation_scroll.test.js +92 -0
  89. data/app/javascript/controllers/comments/__tests__/topics_controller_delete.test.js +130 -0
  90. data/app/javascript/controllers/comments/__tests__/topics_controller_docked.test.js +32 -0
  91. data/app/javascript/controllers/comments/__tests__/topics_controller_last_topic_echo.test.js +1938 -0
  92. data/app/javascript/controllers/comments/__tests__/topics_controller_primary_agent.test.js +256 -0
  93. data/app/javascript/controllers/comments/__tests__/topics_controller_scroll.test.js +182 -0
  94. data/app/javascript/controllers/comments/__tests__/topics_controller_selection_race.test.js +981 -0
  95. data/app/javascript/controllers/comments/__tests__/topics_controller_topic_list.test.js +313 -0
  96. data/app/javascript/controllers/comments/feature_cards_controller.js +83 -0
  97. data/app/javascript/controllers/comments/form_controller.js +795 -14
  98. data/app/javascript/controllers/comments/list_controller.js +338 -52
  99. data/app/javascript/controllers/comments/placeholder_controller.js +30 -0
  100. data/app/javascript/controllers/comments/popup_controller.js +425 -83
  101. data/app/javascript/controllers/comments/presence_controller.js +317 -55
  102. data/app/javascript/controllers/comments/prev_message_navigator.js +94 -0
  103. data/app/javascript/controllers/comments/topics_controller.js +1772 -100
  104. data/app/javascript/controllers/common_popup_controller.js +2 -2
  105. data/app/javascript/controllers/creatives/__tests__/select_mode_controller.test.js +139 -0
  106. data/app/javascript/controllers/creatives/__tests__/tree_controller.test.js +605 -0
  107. data/app/javascript/controllers/creatives/__tests__/write_access_request_controller.test.js +125 -0
  108. data/app/javascript/controllers/creatives/select_mode_controller.js +7 -2
  109. data/app/javascript/controllers/creatives/tree_controller.js +140 -31
  110. data/app/javascript/controllers/creatives/write_access_request_controller.js +58 -0
  111. data/app/javascript/controllers/desktop_proxy_setup_controller.js +51 -0
  112. data/app/javascript/controllers/gateway_check_controller.js +36 -0
  113. data/app/javascript/controllers/index.js +25 -1
  114. data/app/javascript/controllers/last_visited_creative_controller.js +58 -0
  115. data/app/javascript/controllers/link_creative_controller.js +89 -18
  116. data/app/javascript/controllers/progress_filter_controller.js +12 -22
  117. data/app/javascript/controllers/search_popup_controller.js +64 -46
  118. data/app/javascript/controllers/share_user_search_controller.js +2 -2
  119. data/app/javascript/controllers/topic_list_controller.js +44 -7
  120. data/app/javascript/controllers/workspace_tree_controller.js +662 -0
  121. data/app/javascript/creatives/__tests__/tree_renderer.test.js +80 -0
  122. data/app/javascript/creatives/drag_drop/__tests__/drop_completion_empty_state.test.js +98 -0
  123. data/app/javascript/creatives/drag_drop/__tests__/topic_move_released_agent.test.js +125 -0
  124. data/app/javascript/creatives/drag_drop/event_handlers.js +12 -0
  125. data/app/javascript/creatives/tree_renderer.js +65 -22
  126. data/app/javascript/lib/__tests__/chat_drafts.test.js +1458 -0
  127. data/app/javascript/lib/__tests__/common_popup_bounds.test.js +8 -3
  128. data/app/javascript/lib/__tests__/common_popup_placement.test.js +374 -0
  129. data/app/javascript/lib/__tests__/common_popup_reshow.test.js +131 -0
  130. data/app/javascript/lib/__tests__/creative_link_prefetch.test.js +46 -0
  131. data/app/javascript/lib/__tests__/last_visited_creative.test.js +87 -0
  132. data/app/javascript/lib/__tests__/skill_html_entities.test.js +23 -0
  133. data/app/javascript/lib/__tests__/turbo_stream_actions.test.js +190 -0
  134. data/app/javascript/lib/api/__tests__/creatives.test.js +68 -0
  135. data/app/javascript/lib/api/__tests__/csrf_fetch.test.js +27 -0
  136. data/app/javascript/lib/api/__tests__/topics_save_last_topic.test.js +112 -0
  137. data/app/javascript/lib/api/creatives.js +32 -13
  138. data/app/javascript/lib/api/csrf_fetch.js +6 -4
  139. data/app/javascript/lib/api/topics.js +63 -5
  140. data/app/javascript/lib/chat_drafts.js +786 -0
  141. data/app/javascript/lib/common_popup.js +164 -25
  142. data/app/javascript/lib/creative_link_prefetch.js +27 -0
  143. data/app/javascript/lib/last_visited_creative.js +97 -0
  144. data/app/javascript/lib/lexical/__tests__/creative_link_node.test.js +162 -0
  145. data/app/javascript/lib/lexical/__tests__/creative_link_trigger.test.js +133 -0
  146. data/app/javascript/lib/lexical/__tests__/link_toolbar.test.js +62 -0
  147. data/app/javascript/lib/lexical/creative_link_node.js +101 -0
  148. data/app/javascript/lib/lexical/creative_link_trigger.js +98 -0
  149. data/app/javascript/lib/lexical/link_toolbar.js +23 -0
  150. data/app/javascript/lib/turbo_stream_actions.js +23 -16
  151. data/app/javascript/lib/utils/__tests__/filter_navigation.test.js +210 -0
  152. data/app/javascript/lib/utils/__tests__/markdown.test.js +44 -0
  153. data/app/javascript/lib/utils/filter_navigation.js +100 -0
  154. data/app/javascript/modules/__tests__/command_menu_creative_picker.test.js +62 -0
  155. data/app/javascript/modules/__tests__/command_menu_typeahead.test.js +267 -0
  156. data/app/javascript/modules/__tests__/creative_link_picker.test.js +85 -0
  157. data/app/javascript/modules/__tests__/creative_row_editor_archive.test.js +391 -0
  158. data/app/javascript/modules/__tests__/creative_row_editor_delegated_clicks.test.js +158 -0
  159. data/app/javascript/modules/__tests__/creative_row_editor_empty_state_recovery.test.js +519 -0
  160. data/app/javascript/modules/__tests__/creative_row_editor_empty_state_removal.test.js +346 -0
  161. data/app/javascript/modules/__tests__/creative_row_editor_session.test.js +144 -0
  162. data/app/javascript/modules/__tests__/creative_tree_dom.test.js +30 -0
  163. data/app/javascript/modules/__tests__/creative_tree_empty_state.test.js +186 -0
  164. data/app/javascript/modules/__tests__/dom_listener_registry.test.js +67 -0
  165. data/app/javascript/modules/__tests__/support/inline_editor_dom.js +159 -0
  166. data/app/javascript/modules/command_args_form.js +0 -12
  167. data/app/javascript/modules/command_menu.js +80 -38
  168. data/app/javascript/modules/creative_link_picker.js +56 -0
  169. data/app/javascript/modules/creative_row_editor.js +446 -243
  170. data/app/javascript/modules/creative_row_editor_delegated_clicks.js +87 -0
  171. data/app/javascript/modules/creative_tree_dom.js +4 -0
  172. data/app/javascript/modules/creative_tree_empty_state.js +80 -0
  173. data/app/javascript/modules/dom_listener_registry.js +23 -0
  174. data/app/javascript/modules/mention_menu.js +2 -3
  175. data/app/javascript/utils/__tests__/caret_anchor.test.js +75 -0
  176. data/app/javascript/utils/__tests__/chevron_icons.test.js +15 -0
  177. data/app/javascript/utils/caret_position.js +10 -0
  178. data/app/javascript/utils/chevron_icons.js +7 -0
  179. data/app/jobs/collavre/ai_agent_job.rb +262 -72
  180. data/app/jobs/collavre/cancel_offline_delegated_tasks_job.rb +11 -36
  181. data/app/jobs/collavre/comment_badges_broadcast_job.rb +28 -0
  182. data/app/jobs/collavre/comment_link_preview_job.rb +33 -0
  183. data/app/jobs/collavre/comment_notification_job.rb +14 -0
  184. data/app/jobs/collavre/comment_push_delivery_sweep_job.rb +17 -0
  185. data/app/jobs/collavre/compress_job.rb +33 -22
  186. data/app/jobs/collavre/creative_broadcast_job.rb +161 -48
  187. data/app/jobs/collavre/cron_action_job.rb +36 -18
  188. data/app/jobs/collavre/drop_trigger_job.rb +23 -9
  189. data/app/jobs/collavre/merge_comments_job.rb +33 -16
  190. data/app/jobs/collavre/push_notification_job.rb +62 -18
  191. data/app/jobs/collavre/restore_dropped_dispatches_job.rb +17 -0
  192. data/app/jobs/collavre/stuck_detector_job.rb +1 -1
  193. data/app/jobs/collavre/touch_creative_subtree_job.rb +14 -0
  194. data/app/models/collavre/agent_gateway.rb +200 -0
  195. data/app/models/collavre/agent_subscription.rb +4 -4
  196. data/app/models/collavre/agent_workspace.rb +210 -0
  197. data/app/models/collavre/comment/broadcastable.rb +22 -52
  198. data/app/models/collavre/comment/notifiable.rb +154 -77
  199. data/app/models/collavre/comment/topic_membership.rb +41 -0
  200. data/app/models/collavre/comment.rb +336 -31
  201. data/app/models/collavre/comment_notification_delivery.rb +61 -0
  202. data/app/models/collavre/comment_presence_store/cache_batches.rb +64 -0
  203. data/app/models/collavre/comment_presence_store.rb +272 -12
  204. data/app/models/collavre/comment_read_pointer.rb +9 -15
  205. data/app/models/collavre/creative/describable.rb +8 -2
  206. data/app/models/collavre/creative/permissible.rb +11 -0
  207. data/app/models/collavre/creative.rb +29 -4
  208. data/app/models/collavre/creative_share.rb +109 -4
  209. data/app/models/collavre/current.rb +1 -0
  210. data/app/models/collavre/llm_model.rb +62 -0
  211. data/app/models/collavre/system_setting.rb +12 -1
  212. data/app/models/collavre/task.rb +121 -2
  213. data/app/models/collavre/topic.rb +51 -0
  214. data/app/models/collavre/user.rb +101 -41
  215. data/app/models/collavre/user_creative_preference.rb +3 -1
  216. data/app/services/collavre/agent_provisioning/archive.rb +108 -0
  217. data/app/services/collavre/ai_agent/a2a_dispatcher.rb +16 -3
  218. data/app/services/collavre/ai_agent/agent_lifecycle_manager.rb +63 -6
  219. data/app/services/collavre/ai_agent/approval_handler.rb +12 -4
  220. data/app/services/collavre/ai_agent/claude_channel_adapter.rb +10 -5
  221. data/app/services/collavre/ai_agent/merged_trigger_comments.rb +164 -0
  222. data/app/services/collavre/ai_agent/message_builder.rb +103 -16
  223. data/app/services/collavre/ai_agent/session_provisioner.rb +3 -7
  224. data/app/services/collavre/ai_agent/task_claim_service.rb +29 -15
  225. data/app/services/collavre/ai_agent/task_reply_service.rb +67 -0
  226. data/app/services/collavre/ai_agent_service.rb +108 -20
  227. data/app/services/collavre/ai_client.rb +211 -21
  228. data/app/services/collavre/cli_proxy/client.rb +147 -0
  229. data/app/services/collavre/cli_proxy/endpoint_policy.rb +81 -0
  230. data/app/services/collavre/cli_proxy/identity.rb +47 -0
  231. data/app/services/collavre/cli_proxy/safe_net_http_adapter.rb +19 -0
  232. data/app/services/collavre/command_menu_service.rb +0 -10
  233. data/app/services/collavre/comment_move_service.rb +96 -7
  234. data/app/services/collavre/comment_snapshot_restore_service.rb +11 -5
  235. data/app/services/collavre/comments/action_executor.rb +48 -20
  236. data/app/services/collavre/comments/command_processor.rb +0 -1
  237. data/app/services/collavre/comments/list_response.rb +133 -0
  238. data/app/services/collavre/comments/read_pointer_writer.rb +210 -0
  239. data/app/services/collavre/comments/read_receipt_broadcaster.rb +157 -0
  240. data/app/services/collavre/comments/read_receipt_index.rb +152 -0
  241. data/app/services/collavre/comments/topic_command.rb +72 -1
  242. data/app/services/collavre/comments/topic_mutation.rb +20 -0
  243. data/app/services/collavre/creatives/breadcrumb_resolver.rb +1 -1
  244. data/app/services/collavre/creatives/comment_badge_index.rb +299 -27
  245. data/app/services/collavre/creatives/reorderer.rb +15 -3
  246. data/app/services/collavre/creatives/tree_builder.rb +1 -1
  247. data/app/services/collavre/creatives/tree_formatter.rb +5 -6
  248. data/app/services/collavre/creatives/workspace_path_resolver.rb +50 -0
  249. data/app/services/collavre/creatives/workspace_tree_builder.rb +92 -0
  250. data/app/services/collavre/crons/recurring_topic_tasks.rb +23 -0
  251. data/app/services/collavre/home_page_path.rb +55 -0
  252. data/app/services/collavre/html_text.rb +64 -0
  253. data/app/services/collavre/http_client.rb +11 -2
  254. data/app/services/collavre/inbox_reply_service.rb +1 -1
  255. data/app/services/collavre/markdown_converter.rb +13 -1
  256. data/app/services/collavre/orchestration/agent_orchestrator.rb +776 -81
  257. data/app/services/collavre/orchestration/arbiter.rb +48 -5
  258. data/app/services/collavre/orchestration/deferred_trigger_scope.rb +53 -0
  259. data/app/services/collavre/orchestration/delivery_record.rb +792 -0
  260. data/app/services/collavre/orchestration/loop_breaker.rb +10 -4
  261. data/app/services/collavre/orchestration/matcher.rb +132 -17
  262. data/app/services/collavre/orchestration/policy_resolver.rb +58 -10
  263. data/app/services/collavre/orchestration/scheduler.rb +10 -4
  264. data/app/services/collavre/orchestration/scheduling_hooks.rb +10 -0
  265. data/app/services/collavre/orchestration/selection.rb +43 -0
  266. data/app/services/collavre/orchestration/stuck_detector.rb +25 -112
  267. data/app/services/collavre/orchestration/task_coalescer.rb +355 -0
  268. data/app/services/collavre/orchestration/topic_slot.rb +73 -0
  269. data/app/services/collavre/system_events/context_builder.rb +60 -11
  270. data/app/services/collavre/system_events/dispatcher.rb +58 -12
  271. data/app/services/collavre/system_events/envelope.rb +73 -0
  272. data/app/services/collavre/system_events/vocabulary.rb +45 -0
  273. data/app/services/collavre/tools/creative_retrieval_service.rb +1 -1
  274. data/app/services/collavre/tools/cron_create_service.rb +32 -18
  275. data/app/services/collavre/tools/id_list.rb +38 -0
  276. data/app/services/collavre/tools/topic_authorizer.rb +61 -7
  277. data/app/services/collavre/tools/topic_branch_service.rb +85 -0
  278. data/app/services/collavre/tools/topic_create_service.rb +117 -0
  279. data/app/services/collavre/tools/topic_list_service.rb +101 -0
  280. data/app/services/collavre/tools/topic_message_create_service.rb +192 -0
  281. data/app/services/collavre/tools/topic_messages_service.rb +346 -0
  282. data/app/services/collavre/tools/topic_move_service.rb +108 -0
  283. data/app/services/collavre/tools/topic_selection.rb +59 -0
  284. data/app/services/collavre/tools/topic_update_service.rb +165 -0
  285. data/app/services/collavre/topic_branch_service.rb +39 -10
  286. data/app/services/collavre/topics/agent_resolver.rb +87 -0
  287. data/app/services/collavre/topics/char_budget.rb +70 -0
  288. data/app/services/collavre/topics/last_topic_preference_payload.rb +18 -0
  289. data/app/services/collavre/topics/message_page.rb +380 -0
  290. data/app/services/collavre/topics/message_page_markdown.rb +102 -0
  291. data/app/services/collavre/topics/message_scope.rb +61 -0
  292. data/app/services/collavre/topics/message_stats.rb +92 -0
  293. data/app/services/collavre/topics/move_blocker.rb +47 -0
  294. data/app/services/collavre/topics/next_name.rb +35 -0
  295. data/app/services/collavre/topics/pin_rejection.rb +25 -0
  296. data/app/services/collavre/topics/read_pointer_relocator.rb +71 -0
  297. data/app/services/collavre/topics/reserved_name.rb +18 -0
  298. data/app/services/collavre/topics/serializer.rb +92 -0
  299. data/app/services/collavre/topics/topic_destroy.rb +30 -0
  300. data/app/services/collavre/topics/topic_move.rb +80 -0
  301. data/app/services/collavre/topics/topic_move_effects.rb +35 -0
  302. data/app/services/collavre/topics/topic_mutation.rb +27 -0
  303. data/app/views/collavre/admin/integrations/_setting_row.html.erb +5 -8
  304. data/app/views/collavre/admin/settings/_system_tab.html.erb +7 -0
  305. data/app/views/collavre/agent_connections/show.html.erb +77 -0
  306. data/app/views/collavre/agent_gateways/_form.html.erb +71 -0
  307. data/app/views/collavre/agent_gateways/edit.html.erb +2 -0
  308. data/app/views/collavre/agent_gateways/index.html.erb +54 -0
  309. data/app/views/collavre/agent_gateways/new.html.erb +2 -0
  310. data/app/views/collavre/comments/_comments_popup.html.erb +32 -17
  311. data/app/views/collavre/comments/_empty_state.html.erb +33 -0
  312. data/app/views/collavre/comments/_empty_state_minimal.html.erb +7 -0
  313. data/app/views/collavre/comments/_feature_card.html.erb +35 -0
  314. data/app/views/collavre/comments/_list.html.erb +3 -2
  315. data/app/views/collavre/comments/_no_search_results.html.erb +3 -0
  316. data/app/views/collavre/creatives/_add_button.html.erb +17 -19
  317. data/app/views/collavre/creatives/_empty_state.html.erb +109 -0
  318. data/app/views/collavre/creatives/_inline_edit_form.html.erb +5 -5
  319. data/app/views/collavre/creatives/_tree_loading_placeholder.html.erb +16 -0
  320. data/app/views/collavre/creatives/_workspace_tree.html.erb +33 -0
  321. data/app/views/collavre/creatives/index.html.erb +79 -18
  322. data/app/views/collavre/desktop_setup/show.html.erb +114 -0
  323. data/app/views/collavre/features/index.html.erb +42 -0
  324. data/app/views/collavre/features/show.html.erb +52 -0
  325. data/app/views/collavre/invitation_mailer/invite.html.erb +1 -1
  326. data/app/views/collavre/invitation_mailer/invite.text.erb +1 -1
  327. data/app/views/collavre/invites/show.html.erb +14 -1
  328. data/app/views/collavre/landing/show.html.erb +5 -1
  329. data/app/views/collavre/shared/_link_creative_modal.html.erb +4 -1
  330. data/app/views/collavre/shared/navigation/_help_button.html.erb +3 -1
  331. data/app/views/collavre/shared/navigation/_panels.html.erb +1 -8
  332. data/app/views/collavre/shared/navigation/_search_form.html.erb +13 -2
  333. data/app/views/collavre/user_themes/index.html.erb +1 -1
  334. data/app/views/collavre/users/_llm_fields.html.erb +65 -0
  335. data/app/views/collavre/users/_org_chart_node.html.erb +1 -1
  336. data/app/views/collavre/users/edit_ai.html.erb +33 -31
  337. data/app/views/collavre/users/new.html.erb +4 -2
  338. data/app/views/collavre/users/new_ai.html.erb +14 -32
  339. data/app/views/collavre/users/show.html.erb +13 -1
  340. data/app/views/layouts/collavre/landing.html.erb +9 -4
  341. data/config/initializers/ruby_llm_openai_reasoning_content.rb +77 -0
  342. data/config/locales/admin.en.yml +3 -1
  343. data/config/locales/admin.ko.yml +3 -1
  344. data/config/locales/agent_gateway.en.yml +217 -0
  345. data/config/locales/agent_gateway.ko.yml +217 -0
  346. data/config/locales/ai_agent.en.yml +0 -1
  347. data/config/locales/ai_agent.ko.yml +0 -1
  348. data/config/locales/comments.en.yml +72 -30
  349. data/config/locales/comments.ko.yml +72 -30
  350. data/config/locales/creatives.en.yml +32 -1
  351. data/config/locales/creatives.ko.yml +32 -1
  352. data/config/locales/features.en.yml +140 -0
  353. data/config/locales/features.ko.yml +140 -0
  354. data/config/locales/invites.en.yml +3 -0
  355. data/config/locales/invites.ko.yml +3 -0
  356. data/config/locales/landing.en.yml +2 -1
  357. data/config/locales/landing.ko.yml +2 -1
  358. data/config/locales/tools.en.yml +20 -0
  359. data/config/locales/tools.ko.yml +20 -0
  360. data/config/locales/users.en.yml +15 -14
  361. data/config/locales/users.ko.yml +14 -14
  362. data/config/routes.rb +45 -19
  363. data/db/migrate/20250911084338_backfill_creative_in_comment_inbox_items.rb +9 -1
  364. data/db/migrate/20260724000000_add_creative_id_index_to_comments.rb +34 -0
  365. data/db/migrate/20260724000001_add_creative_private_id_index_to_comments.rb +50 -0
  366. data/db/migrate/20260724090000_add_async_comment_notification_state.rb +64 -0
  367. data/db/migrate/20260727000000_add_waiting_notice_scope_to_comments.rb +30 -0
  368. data/db/migrate/20260727010000_add_waiting_notice_scope_to_tasks.rb +26 -0
  369. data/db/migrate/20260805000000_add_creative_workspace_enabled_to_users.rb +5 -0
  370. data/db/migrate/20260807050000_add_dismissed_notices_to_users.rb +5 -0
  371. data/db/migrate/20260809000000_change_creative_workspace_enabled_default_to_true.rb +18 -0
  372. data/db/migrate/20260809000001_create_llm_models.rb +64 -0
  373. data/db/migrate/20260809000002_create_agent_gateways_and_workspaces.rb +35 -0
  374. data/db/migrate/20260809000003_hash_agent_workspace_callback_tokens.rb +44 -0
  375. data/db/migrate/20260809000004_encrypt_agent_workspace_manifest_tokens.rb +59 -0
  376. data/db/migrate/20260810000000_split_agent_workspace_identity_axes.rb +58 -0
  377. data/db/migrate/20260810000001_seed_codex_custom_proxy_llm_models.rb +28 -0
  378. data/db/migrate/20260810010000_add_last_visited_creative_to_users.rb +8 -0
  379. data/db/migrate/20260810020000_add_last_visited_creative_at_to_users.rb +5 -0
  380. data/db/migrate/20260810030000_add_last_visited_creative_navigation_order_to_users.rb +6 -0
  381. data/db/migrate/20260810060000_add_last_visited_creative_issued_sequence_to_users.rb +5 -0
  382. data/db/migrate/20260810100000_add_desktop_managed_to_agent_gateways.rb +40 -0
  383. data/db/migrate/20260810100001_add_desktop_preset_adapter_to_users.rb +38 -0
  384. data/db/migrate/20260811000000_make_agent_gateway_completion_key_nullable.rb +7 -0
  385. data/db/migrate/20260812000000_remove_workflow_columns_from_tasks.rb +101 -0
  386. data/db/migrate/20260812000001_remove_android_devices.rb +24 -0
  387. data/db/migrate/20260812010000_drop_inbox_items.rb +22 -0
  388. data/db/migrate/20260813000000_clear_claude_channel_presence_routing_expressions.rb +16 -0
  389. data/db/migrate/20260813000001_add_last_topic_revision_to_user_creative_preferences.rb +5 -0
  390. data/db/migrate/20260813000002_add_last_topic_save_order_to_user_creative_preferences.rb +6 -0
  391. data/db/migrate/20260813000003_add_last_topic_save_sequences_to_user_creative_preferences.rb +5 -0
  392. data/db/migrate/20260813000004_add_last_topic_save_fences_to_user_creative_preferences.rb +6 -0
  393. data/db/migrate/20260814000000_add_topic_to_comment_read_pointers.rb +79 -0
  394. data/db/migrate/20260814000001_add_creative_topic_private_id_index_to_comments.rb +37 -0
  395. data/db/migrate/20260816000000_add_watermark_index_to_comment_read_pointers.rb +27 -0
  396. data/db/migrate/20260816000001_add_private_recipient_topic_index_to_comments.rb +48 -0
  397. data/db/migrate/20260820000000_add_topic_assigned_at_to_comments.rb +13 -0
  398. data/db/seeds.rb +1 -51
  399. data/lib/collavre/engine.rb +108 -1
  400. data/lib/collavre/feature_card_registry.rb +168 -0
  401. data/lib/collavre/hashed_access_token_lookup.rb +22 -0
  402. data/lib/collavre/sensitive_request_silencer.rb +23 -0
  403. data/lib/collavre/user_extensions.rb +0 -2
  404. data/lib/collavre/version.rb +1 -1
  405. data/lib/collavre.rb +1 -0
  406. data/skills/collavre/SKILL.md +165 -0
  407. data/skills/collavre/package.json +8 -0
  408. data/skills/collavre/references/tool-reference.md +347 -0
  409. data/skills/collavre/scripts/collavre +634 -0
  410. data/skills/collavre/scripts/html_entities.js +24 -0
  411. metadata +228 -30
  412. data/app/controllers/collavre/api/v1/mobile/agent_events_controller.rb +0 -224
  413. data/app/controllers/collavre/api/v1/mobile/base_controller.rb +0 -95
  414. data/app/controllers/collavre/api/v1/mobile/devices_controller.rb +0 -31
  415. data/app/controllers/collavre/api/v1/mobile/voice_commands_controller.rb +0 -25
  416. data/app/controllers/collavre/inbox_items_controller.rb +0 -70
  417. data/app/controllers/collavre/typo_corrections_controller.rb +0 -39
  418. data/app/javascript/lib/__tests__/typo_correction.test.js +0 -192
  419. data/app/javascript/lib/typo_correction.js +0 -146
  420. data/app/javascript/modules/__tests__/typo_corrector.test.js +0 -365
  421. data/app/javascript/modules/creative_guide.js +0 -67
  422. data/app/javascript/modules/typo_corrector.js +0 -534
  423. data/app/jobs/collavre/inbox_summary_job.rb +0 -24
  424. data/app/mailers/collavre/inbox_mailer.rb +0 -19
  425. data/app/models/collavre/inbox_item.rb +0 -89
  426. data/app/services/collavre/comments/concerns/workflow_support.rb +0 -115
  427. data/app/services/collavre/comments/work_command.rb +0 -161
  428. data/app/services/collavre/comments/workflow_executor.rb +0 -276
  429. data/app/services/collavre/gemini_parent_recommender.rb +0 -77
  430. data/app/services/collavre/mobile/event_summarizer.rb +0 -40
  431. data/app/services/collavre/typo_corrector.rb +0 -188
  432. data/app/views/collavre/inbox_items/_item.html.erb +0 -18
  433. data/app/views/collavre/inbox_items/_items.html.erb +0 -3
  434. data/app/views/collavre/inbox_items/_list.html.erb +0 -7
  435. data/app/views/collavre/inbox_items/index.html.erb +0 -1
  436. data/app/views/collavre/inbox_mailer/daily_summary.html.erb +0 -11
  437. data/app/views/collavre/inbox_mailer/daily_summary.text.erb +0 -8
  438. data/app/views/collavre/users/typo_correction.html.erb +0 -50
  439. data/config/locales/mobile.en.yml +0 -16
  440. data/config/locales/mobile.ko.yml +0 -16
@@ -1,30 +1,290 @@
1
+ require "digest"
2
+ require "monitor"
3
+
1
4
  module Collavre
2
5
  class CommentPresenceStore
6
+ extend CacheBatches
3
7
  KEY_PREFIX = "comment_presence:"
8
+ TOPIC_KEY_PREFIX = "comment_presence_topic:"
9
+ SUBSCRIPTIONS_KEY_PREFIX = "comment_presence_subscriptions:"
10
+ LOCK_KEY_PREFIX = "comment_presence_lock:"
11
+ ALL_TOPICS = "all"
12
+ LEGACY_TOPIC = "_legacy"
13
+ LEGACY_SUBSCRIPTION_ID = "legacy"
14
+ LOCK_PURPOSE = "collavre:comment_presence".freeze
15
+ SUBSCRIPTION_TTL = 90.seconds
16
+
17
+ @mutex_registry_guard = Mutex.new
18
+ @mutex_registry = {}
19
+
20
+ def self.add(creative_id, user_id, subscription_id: LEGACY_SUBSCRIPTION_ID)
21
+ with_lock(creative_id) do
22
+ subscriptions = subscription_ids(creative_id, user_id)
23
+ unless subscriptions.include?(subscription_id)
24
+ subscriptions << subscription_id
25
+ end
26
+ write_subscriptions(creative_id, user_id, subscriptions)
27
+ renew_subscription(creative_id, user_id, subscription_id)
28
+
29
+ ids = list(creative_id)
30
+ unless ids.include?(user_id)
31
+ ids << user_id
32
+ end
33
+ write_present_user_ids(creative_id, ids)
34
+ ids
35
+ end
36
+ end
37
+
38
+ def self.remove(creative_id, user_id, subscription_id: LEGACY_SUBSCRIPTION_ID)
39
+ with_lock(creative_id) do
40
+ Rails.cache.delete(subscription_lease_key(creative_id, user_id, subscription_id))
41
+ subscriptions = subscription_ids(creative_id, user_id)
42
+ subscriptions.any? ? write_subscriptions(creative_id, user_id, subscriptions) : Rails.cache.delete(subscriptions_key(creative_id, user_id))
43
+ Rails.cache.delete(topic_key(creative_id, user_id, subscription_id))
44
+
45
+ next list(creative_id) if subscriptions.any?
4
46
 
5
- def self.add(creative_id, user_id)
6
- ids = list(creative_id)
7
- unless ids.include?(user_id)
8
- ids << user_id
9
- Rails.cache.write(key(creative_id), ids)
47
+ ids = list(creative_id)
48
+ if ids.delete(user_id)
49
+ write_present_user_ids(creative_id, ids)
50
+ end
51
+ ids
10
52
  end
11
- ids
12
53
  end
13
54
 
14
- def self.remove(creative_id, user_id)
15
- ids = list(creative_id)
16
- if ids.delete(user_id)
17
- Rails.cache.write(key(creative_id), ids)
55
+ def self.set_topic(creative_id, user_id, topic_id, subscription_id: LEGACY_SUBSCRIPTION_ID, rendered_topic_ids: [], rendered_legacy_topic: false)
56
+ with_lock(creative_id) do
57
+ subscriptions = subscription_ids(creative_id, user_id)
58
+ subscriptions << subscription_id unless subscriptions.include?(subscription_id)
59
+ write_subscriptions(creative_id, user_id, subscriptions)
60
+ renew_subscription(creative_id, user_id, subscription_id)
61
+ viewed_topics = if topic_id
62
+ topic_id.to_i
63
+ else
64
+ [ ALL_TOPICS, *Array(rendered_topic_ids).map(&:to_i), *(rendered_legacy_topic ? [ LEGACY_TOPIC ] : []) ].uniq
65
+ end
66
+ Rails.cache.write(topic_key(creative_id, user_id, subscription_id), viewed_topics, expires_in: SUBSCRIPTION_TTL)
67
+
68
+ ids = list(creative_id)
69
+ ids << user_id unless ids.include?(user_id)
70
+ write_present_user_ids(creative_id, ids)
71
+ end
72
+ end
73
+
74
+ # Action Cable's disconnect callback is best-effort. Refresh an expiring
75
+ # subscription lease while the socket remains connected so a crashed process
76
+ # cannot leave a user suppressing badges indefinitely.
77
+ def self.renew(creative_id, user_id, subscription_id: LEGACY_SUBSCRIPTION_ID)
78
+ with_lock(creative_id) do
79
+ return false unless stored_subscription_ids(creative_id, user_id).include?(subscription_id)
80
+
81
+ subscriptions = subscription_ids(creative_id, user_id)
82
+ subscriptions << subscription_id unless subscriptions.include?(subscription_id)
83
+ write_subscriptions(creative_id, user_id, subscriptions)
84
+ renew_subscription(creative_id, user_id, subscription_id)
85
+ renew_topic(creative_id, user_id, subscription_id)
86
+ ids = list(creative_id)
87
+ ids << user_id unless ids.include?(user_id)
88
+ write_present_user_ids(creative_id, ids)
89
+ true
90
+ end
91
+ end
92
+
93
+ def self.topic_for(creative_id, user_id)
94
+ topics = viewing_topics(creative_id, user_id)
95
+ return if topics.include?(ALL_TOPICS)
96
+
97
+ topics.first
98
+ end
99
+
100
+ def self.viewing_all_topics?(creative_id, user_id)
101
+ viewing_topics(creative_id, user_id).include?(ALL_TOPICS)
102
+ end
103
+
104
+ # A user can have several open chat subscriptions. Keep every subscription's
105
+ # selected topic so closing one tab cannot erase another tab's suppression.
106
+ def self.viewing_topics(creative_id, user_id)
107
+ ids = subscription_ids(creative_id, user_id)
108
+ ids << LEGACY_SUBSCRIPTION_ID if ids.empty? && Rails.cache.exist?(topic_key(creative_id, user_id))
109
+ Rails.cache.read_multi(*ids.map { |subscription_id| topic_key(creative_id, user_id, subscription_id) }).values.flat_map { |topics| Array(topics) }.compact.uniq
110
+ end
111
+
112
+ # Fetch selected topics for all present recipients in cache batches. Badge
113
+ # fanout has one creative and many recipients, so calling #viewing_topics
114
+ # for each one would otherwise turn the cache work back into an N+1.
115
+ def self.viewing_topics_for(creative_id, user_ids)
116
+ ids = Array(user_ids).uniq
117
+ return {} if ids.empty?
118
+
119
+ subscription_keys_by_user_id = ids.to_h { |user_id| [ user_id, subscriptions_key(creative_id, user_id) ] }
120
+ cached_subscriptions = Rails.cache.read_multi(*subscription_keys_by_user_id.values)
121
+ topic_keys_by_user_id = ids.to_h do |user_id|
122
+ subscription_ids = cached_subscriptions.fetch(subscription_keys_by_user_id.fetch(user_id), [])
123
+ subscription_ids = [ LEGACY_SUBSCRIPTION_ID ] if subscription_ids.empty?
124
+ [ user_id, subscription_ids.map { |subscription_id| topic_key(creative_id, user_id, subscription_id) } ]
18
125
  end
19
- ids
126
+ cached_topics = Rails.cache.read_multi(*topic_keys_by_user_id.values.flatten)
127
+
128
+ topic_keys_by_user_id.transform_values do |topic_keys|
129
+ topic_keys.flat_map { |topic_key| Array(cached_topics[topic_key]) }.compact.uniq
130
+ end
131
+ end
132
+
133
+ # Tree badges need the selected-topic snapshots for one user across many
134
+ # creatives. Fetch the subscription and topic entries in two cache batches
135
+ # rather than reading each creative independently.
136
+ def self.viewing_topics_for_creatives(user_id, creative_ids)
137
+ ids = Array(creative_ids).uniq
138
+ return {} if ids.empty?
139
+
140
+ subscription_keys = ids.to_h { |creative_id| [ creative_id, subscriptions_key(creative_id, user_id) ] }
141
+ subscriptions = Rails.cache.read_multi(*subscription_keys.values)
142
+ active_subscriptions = active_subscriptions_for_creatives(ids, user_id, subscription_keys, subscriptions)
143
+ viewing_topics_from_subscriptions(active_subscriptions, user_id)
20
144
  end
21
145
 
22
146
  def self.list(creative_id)
23
- Rails.cache.read(key(creative_id)) || []
147
+ list_many([ creative_id ]).fetch(creative_id)
148
+ end
149
+
150
+ # Presence for many creatives in one round trip.
151
+ #
152
+ # Rails.cache is :solid_cache_store in production — the app's own database —
153
+ # so a per-node `list` while rendering a creative tree is a SELECT per node.
154
+ # The LocalCache middleware that fronts Rails.cache for the duration of a
155
+ # request does not help: it memoizes per *key*, and presence is keyed by
156
+ # creative, so a tree of N nodes asks for N different keys. Repeated reads of
157
+ # the single completion-mark setting are memoized separately by the request's
158
+ # view context.
159
+ #
160
+ # Returns an entry for every id asked for, empty when nobody is present, so
161
+ # callers never have to distinguish "absent from the cache" from "nobody
162
+ # there".
163
+ def self.list_many(creative_ids)
164
+ ids = Array(creative_ids).uniq
165
+ return {} if ids.empty?
166
+
167
+ user_ids_by_creative_id = cached_user_ids(ids)
168
+ subscriptions = cached_subscriptions_for(user_ids_by_creative_id)
169
+ leases = cached_subscription_leases(user_ids_by_creative_id, subscriptions)
170
+ present_users_from_cache(user_ids_by_creative_id, subscriptions, leases)
24
171
  end
25
172
 
26
173
  def self.key(creative_id)
27
174
  "#{KEY_PREFIX}#{creative_id}"
28
175
  end
176
+
177
+ def self.topic_key(creative_id, user_id, subscription_id = LEGACY_SUBSCRIPTION_ID)
178
+ "#{TOPIC_KEY_PREFIX}#{creative_id}:#{user_id}:#{subscription_id}"
179
+ end
180
+
181
+ def self.subscriptions_key(creative_id, user_id)
182
+ "#{SUBSCRIPTIONS_KEY_PREFIX}#{creative_id}:#{user_id}"
183
+ end
184
+
185
+ def self.subscription_lease_key(creative_id, user_id, subscription_id = LEGACY_SUBSCRIPTION_ID)
186
+ "#{SUBSCRIPTIONS_KEY_PREFIX}#{creative_id}:#{user_id}:#{subscription_id}:lease"
187
+ end
188
+
189
+ def self.lock_key(creative_id)
190
+ "#{LOCK_KEY_PREFIX}#{creative_id}"
191
+ end
192
+
193
+ def self.subscription_ids(creative_id, user_id)
194
+ subscription_ids = stored_subscription_ids(creative_id, user_id)
195
+ lease_keys = subscription_ids.to_h { |subscription_id| [ subscription_id, subscription_lease_key(creative_id, user_id, subscription_id) ] }
196
+ leases = Rails.cache.read_multi(*lease_keys.values)
197
+ lease_keys.filter_map { |subscription_id, lease_key| subscription_id if leases[lease_key] }
198
+ end
199
+
200
+ def self.stored_subscription_ids(creative_id, user_id)
201
+ Rails.cache.read(subscriptions_key(creative_id, user_id)) || []
202
+ end
203
+
204
+ def self.write_subscriptions(creative_id, user_id, subscriptions)
205
+ Rails.cache.write(subscriptions_key(creative_id, user_id), subscriptions, expires_in: SUBSCRIPTION_TTL)
206
+ end
207
+
208
+ def self.renew_subscription(creative_id, user_id, subscription_id)
209
+ Rails.cache.write(subscription_lease_key(creative_id, user_id, subscription_id), true, expires_in: SUBSCRIPTION_TTL)
210
+ end
211
+
212
+ def self.renew_topic(creative_id, user_id, subscription_id)
213
+ key = topic_key(creative_id, user_id, subscription_id)
214
+ topic = Rails.cache.read(key)
215
+ Rails.cache.write(key, topic, expires_in: SUBSCRIPTION_TTL) unless topic.nil?
216
+ end
217
+
218
+ def self.write_present_user_ids(creative_id, ids)
219
+ Rails.cache.write(key(creative_id), ids, expires_in: SUBSCRIPTION_TTL)
220
+ end
221
+
222
+ def self.active_subscription_ids_from_cache(creative_id, user_id, subscriptions, leases)
223
+ Array(subscriptions[subscriptions_key(creative_id, user_id)]).filter do |subscription_id|
224
+ leases[subscription_lease_key(creative_id, user_id, subscription_id)]
225
+ end
226
+ end
227
+
228
+
229
+ # Membership changes update several cache entries, so serialize them across
230
+ # Action Cable processes. PostgreSQL advisory locks are held for the life of
231
+ # the database session: they cannot expire while a holder is still mutating
232
+ # state, and PostgreSQL releases them when a crashed process disconnects.
233
+ # SQLite is used for the single-process desktop app and tests.
234
+ def self.with_lock(creative_id, &block)
235
+ if postgres_cache?
236
+ with_postgres_lock(creative_id, &block)
237
+ else
238
+ with_process_lock(creative_id, &block)
239
+ end
240
+ end
241
+
242
+ def self.postgres_cache?
243
+ defined?(SolidCache::Entry) && SolidCache::Entry.connection.adapter_name.casecmp?("PostgreSQL")
244
+ end
245
+
246
+ def self.with_postgres_lock(creative_id)
247
+ SolidCache::Entry.connection_pool.with_connection do |connection|
248
+ advisory_key = advisory_lock_key(creative_id)
249
+ # Register cleanup before acquisition so an interruption after the
250
+ # server grants the lock cannot return a locked session to the pool.
251
+ unlock_required = true
252
+ connection.select_value("SELECT pg_advisory_lock(#{connection.quote(advisory_key)})")
253
+ yield
254
+ ensure
255
+ if unlock_required
256
+ connection.select_value("SELECT pg_advisory_unlock(#{connection.quote(advisory_key)})")
257
+ end
258
+ end
259
+ end
260
+
261
+ def self.advisory_lock_key(creative_id)
262
+ Digest::SHA256.digest("#{LOCK_PURPOSE}:#{creative_id}").unpack1("q>")
263
+ end
264
+
265
+ def self.with_process_lock(creative_id)
266
+ mutex = register_mutex(creative_id)
267
+ mutex.synchronize { yield }
268
+ ensure
269
+ unregister_mutex(creative_id, mutex) if mutex
270
+ end
271
+
272
+ def self.register_mutex(creative_id)
273
+ @mutex_registry_guard.synchronize do
274
+ entry = (@mutex_registry[creative_id] ||= { mutex: Monitor.new, users: 0 })
275
+ entry[:users] += 1
276
+ entry[:mutex]
277
+ end
278
+ end
279
+
280
+ def self.unregister_mutex(creative_id, mutex)
281
+ @mutex_registry_guard.synchronize do
282
+ entry = @mutex_registry[creative_id]
283
+ return unless entry && entry[:mutex].equal?(mutex)
284
+
285
+ entry[:users] -= 1
286
+ @mutex_registry.delete(creative_id) if entry[:users].zero?
287
+ end
288
+ end
29
289
  end
30
290
  end
@@ -4,23 +4,17 @@ module Collavre
4
4
 
5
5
  belongs_to :user, class_name: Collavre.configuration.user_class_name
6
6
  belongs_to :creative, class_name: "Collavre::Creative"
7
+ belongs_to :topic, class_name: "Collavre::Topic", optional: true
7
8
  belongs_to :last_read_comment, class_name: "Collavre::Comment", optional: true
8
9
 
9
- validates :user_id, uniqueness: { scope: :creative_id }
10
+ # A NULL topic is the legacy creative-wide watermark. It remains as a
11
+ # fallback for topics created after the migration.
12
+ validates :user_id, uniqueness: { scope: %i[creative_id topic_id] }
10
13
 
11
- def effective_comment_id(sorted_visible_ids)
12
- return nil unless last_read_comment_id
13
-
14
- # Find the nearest visible comment ID <= last_read_comment_id
15
- idx = sorted_visible_ids.bsearch_index { |x| x > last_read_comment_id }
16
-
17
- if idx
18
- # If idx is 0, target is smaller than all visible IDs
19
- idx > 0 ? sorted_visible_ids[idx - 1] : nil
20
- else
21
- # target is >= all visible IDs
22
- sorted_visible_ids.last
23
- end
24
- end
14
+ # Mapping a pointer onto the comment its receipt avatar renders against lives
15
+ # in Comments::ReadReceiptIndex, which resolves it in the same query that
16
+ # loads the pointers and bounds the lookup to the rendered window. Do not
17
+ # reintroduce a model-side variant: two implementations drift, and the
18
+ # in-Ruby one required loading every public comment id on the creative.
25
19
  end
26
20
  end
@@ -42,12 +42,18 @@ module Collavre
42
42
  if html
43
43
  description_val&.to_s || ""
44
44
  else
45
- ActionController::Base.helpers.strip_tags(description_val&.to_s || "")
45
+ Collavre::HtmlText.plain(description_val)
46
46
  end
47
47
  end
48
48
 
49
49
  def creative_snippet
50
- CGI.unescapeHTML(ActionController::Base.helpers.strip_tags(effective_origin.description || "")).truncate(24, omission: "...")
50
+ Collavre::HtmlText.truncated_label(effective_origin.description, 24)
51
+ end
52
+
53
+ # `creative_snippet` for callers that interpolate it into generated
54
+ # markdown, typically as the text of a `[snippet](path)` link.
55
+ def creative_snippet_markdown
56
+ Collavre::HtmlText.escape_markdown(creative_snippet)
51
57
  end
52
58
 
53
59
  # Read-only-source creatives reject any description change
@@ -24,6 +24,7 @@ module Collavre
24
24
  has_many :creative_shares_caches, class_name: "Collavre::CreativeSharesCache", dependent: :delete_all
25
25
 
26
26
  after_save :accumulate_permission_cache_changes
27
+ after_update :reconcile_topic_read_pointers_for_owner_change, if: :saved_change_to_user_id?
27
28
  after_commit :dispatch_permission_cache_invalidation, unless: :destroyed?
28
29
  after_commit :cache_owner_permission, on: :create
29
30
  after_rollback :clear_accumulated_permission_changes
@@ -166,6 +167,16 @@ module Collavre
166
167
  end
167
168
  end
168
169
 
170
+ # Topic moves preserve a reader's cursor on the source until that reader
171
+ # gains access to the destination. A Creative ownership transfer is one
172
+ # such grant, but it does not touch CreativeShare, so reconcile the new
173
+ # owner's durable pointers here as well.
174
+ def reconcile_topic_read_pointers_for_owner_change
175
+ return unless user_id
176
+
177
+ CreativeShare.reconcile_topic_read_pointers(effective_origin.id, user_ids: [ user_id ])
178
+ end
179
+
169
180
  def cache_owner_permission
170
181
  PermissionCacheJob.perform_later(:cache_owner, creative_id: id)
171
182
  end
@@ -8,8 +8,26 @@ module Collavre
8
8
  # ---------------------------------------------------------------------------
9
9
  # Reserved metadata key registry — engines register their own namespaces so
10
10
  # `update_metadata` preserves them without core naming vendor-specific keys.
11
+ # "kind" must be reserved: it is the discriminator `inbox?`/`Creative.inboxes`
12
+ # match on, so a metadata save that omits it makes the row undiscoverable and
13
+ # `inbox_for` creates a duplicate inbox for that user.
11
14
  # ---------------------------------------------------------------------------
12
- BUILTIN_RESERVED_METADATA_KEYS = %w[markdown_source content_type editor].freeze
15
+ BUILTIN_RESERVED_METADATA_KEYS = %w[markdown_source content_type editor kind].freeze
16
+
17
+ SubtreeTouchTransactionRecord = Data.define(:creative_id) do
18
+ def self.run_commit_callbacks_on_first_saved_instances_in_transaction = true
19
+
20
+ def trigger_transactional_callbacks? = true
21
+
22
+ def before_committed! = nil
23
+
24
+ def committed!(should_run_callbacks:)
25
+ TouchCreativeSubtreeJob.perform_later(creative_id) if should_run_callbacks
26
+ end
27
+
28
+ def rolledback!(**_options) = nil
29
+ end
30
+ private_constant :SubtreeTouchTransactionRecord
13
31
 
14
32
  class << self
15
33
  def registered_reserved_metadata_keys
@@ -44,7 +62,7 @@ module Collavre
44
62
  "creatives/creative"
45
63
  end
46
64
 
47
- after_save :touch_subtree_on_move, if: :saved_change_to_parent_id?
65
+ after_update :register_subtree_touch_after_commit, if: :saved_change_to_parent_id?
48
66
  after_save :fire_drop_trigger_on_move, if: :saved_change_to_parent_id?
49
67
  after_create_commit :fire_drop_trigger_on_create, if: :parent_id?
50
68
  after_create :create_main_topic
@@ -370,8 +388,15 @@ module Collavre
370
388
  end
371
389
  end
372
390
 
373
- def touch_subtree_on_move
374
- descendants.update_all(updated_at: Time.current)
391
+ # Register independently of the Creative instance because a transaction may
392
+ # update the same row through multiple instances, while Rails runs record
393
+ # callbacks on only one of them. Transaction-record equality deduplicates by
394
+ # creative id; Rails promotes records through committed savepoints and drops
395
+ # them on rollback.
396
+ def register_subtree_touch_after_commit
397
+ self.class.with_connection do |connection|
398
+ connection.add_transaction_record(SubtreeTouchTransactionRecord.new(id))
399
+ end
375
400
  end
376
401
 
377
402
  def fire_drop_trigger_on_move
@@ -46,6 +46,9 @@ module Collavre
46
46
  after_destroy :touch_creative_subtree
47
47
 
48
48
  after_commit :dispatch_share_cache_invalidation, on: [ :create, :update ]
49
+ after_create :reconcile_topic_read_pointers_for_permission_change
50
+ after_update :reconcile_topic_read_pointers_for_permission_change, if: :permission_context_changed?
51
+ after_destroy :reconcile_topic_read_pointers_for_permission_change
49
52
  after_commit :broadcast_share_change, on: [ :create, :update ]
50
53
  after_destroy_commit :remove_cache
51
54
  after_destroy_commit :broadcast_share_destroy
@@ -87,10 +90,7 @@ module Collavre
87
90
  return unless Current.user && user
88
91
  return if user.ai_user?
89
92
  inbox_creative = Creative.inbox_for(user)
90
- short_title = ActionController::Base.helpers.truncate(
91
- ActionController::Base.helpers.strip_tags(creative.effective_description),
92
- length: 30
93
- )
93
+ short_title = Collavre::HtmlText.markdown_label(creative.effective_description, 30)
94
94
  creative_path = Collavre::Engine.routes.url_helpers.creative_path(creative, open_comments: true)
95
95
  creative_link = "[#{short_title}](#{creative_path})"
96
96
  msg = I18n.t(
@@ -213,6 +213,111 @@ module Collavre
213
213
  )
214
214
  end
215
215
 
216
+ # Older topic moves could leave a reader's pointer at the former source.
217
+ # Reconcile those historical rows after a share mutation: a direct,
218
+ # inherited, or public grant restores the pointer to its topic's Creative.
219
+ # Pointers remain durable across revocations; read-receipt rendering filters
220
+ # them by current access, so a later grant can restore the exact cursor.
221
+ #
222
+ # Permission caches are refreshed asynchronously, so this resolves the
223
+ # persisted share hierarchy directly rather than consulting has_permission?.
224
+ def reconcile_topic_read_pointers_for_permission_change
225
+ self.class.reconcile_topic_read_pointers(
226
+ reconciliation_creative_ids,
227
+ user_ids: reconciliation_user_ids
228
+ )
229
+ end
230
+
231
+ # Reattaches a durable per-topic cursor to its topic's current Creative
232
+ # whenever a permission change gives a reader access to that destination.
233
+ # It intentionally leaves revoked readers' cursors in place: receipt
234
+ # rendering filters access, and a later grant can then restore the cursor.
235
+ def self.reconcile_topic_read_pointers(destination_ids, user_ids: nil)
236
+ destination_ids = Array(destination_ids).compact.uniq
237
+ return if destination_ids.empty?
238
+
239
+ access_by_destination_and_user = {}
240
+
241
+ pointers = CommentReadPointer.joins(:topic).where(topics: { creative_id: destination_ids })
242
+ pointers = pointers.where(user_id: user_ids) if user_ids
243
+
244
+ pointers
245
+ .includes(:user, topic: :creative)
246
+ .find_each do |pointer|
247
+ destination = pointer.topic.creative
248
+ access_key = [ destination.id, pointer.user_id ]
249
+ has_access = access_by_destination_and_user.fetch(access_key) do
250
+ access_by_destination_and_user[access_key] = read_access_from_shares?(destination, pointer.user)
251
+ end
252
+
253
+ if has_access
254
+ Topics::ReadPointerRelocator.relocate(pointer, destination) unless pointer.creative_id == destination.id
255
+ end
256
+ end
257
+ end
258
+
259
+ # A relocated share changes access in both its new subtree and the subtree it
260
+ # vacated. Keep both in the reconciliation set so the permission transition
261
+ # is evaluated symmetrically.
262
+ def reconciliation_creative_ids
263
+ ids = creative.effective_origin.self_and_descendants.pluck(:id)
264
+ return ids unless saved_change_to_creative_id?
265
+
266
+ previous_creative = Creative.find_by(id: creative_id_before_last_save)
267
+ return ids unless previous_creative
268
+
269
+ ids | previous_creative.effective_origin.self_and_descendants.pluck(:id)
270
+ end
271
+
272
+ # A named share can change access only for its prior or current recipient.
273
+ # A transition to or from public affects every reader, so it deliberately
274
+ # keeps the full scan even when the other side is a named recipient.
275
+ def reconciliation_user_ids
276
+ return user_id ? [ user_id ] : nil if previously_new_record? || destroyed?
277
+ return nil if user_id.nil? || user_id_before_last_save.nil?
278
+
279
+ [ user_id, user_id_before_last_save ].compact.uniq
280
+ end
281
+
282
+ def self.read_access_from_shares?(destination, reader)
283
+ return false unless reader
284
+
285
+ readable_user_ids_from_shares(destination, [ reader.id ]).include?(reader.id)
286
+ end
287
+
288
+ # Resolves access for a group of readers from one snapshot of the creative's
289
+ # share hierarchy. Receipt rendering commonly has one pointer per topic, so
290
+ # checking every pointer independently would repeat the same ancestor and
291
+ # share queries for each topic.
292
+ def self.readable_user_ids_from_shares(destination, user_ids)
293
+ user_ids = user_ids.compact.uniq
294
+ return [] if user_ids.empty?
295
+
296
+ readable_user_ids = user_ids & [ destination.user_id ]
297
+
298
+ ancestor_ids = [ destination.id ] + destination.ancestors.pluck(:id)
299
+ shares_by_user_id = CreativeShare
300
+ .where(creative_id: ancestor_ids, user_id: user_ids + [ nil ])
301
+ .to_a
302
+ .group_by(&:user_id)
303
+ public_share = CreativeShare.closest_parent_share(ancestor_ids, shares_by_user_id[nil])
304
+
305
+ user_ids.each do |user_id|
306
+ next if readable_user_ids.include?(user_id)
307
+
308
+ personal_share = CreativeShare.closest_parent_share(ancestor_ids, shares_by_user_id[user_id])
309
+ effective_share = personal_share || public_share
310
+ readable_user_ids << user_id if effective_share &&
311
+ CreativeShare.permissions.fetch(effective_share.permission) >= CreativeShare.permissions.fetch("read")
312
+ end
313
+
314
+ readable_user_ids
315
+ end
316
+
317
+ def permission_context_changed?
318
+ saved_change_to_permission? || saved_change_to_user_id? || saved_change_to_creative_id?
319
+ end
320
+
216
321
  def permission_allows_access?(value)
217
322
  value.present? && value != "no_access"
218
323
  end
@@ -7,6 +7,7 @@ module Collavre
7
7
  attribute :mcp_tool_approval_required
8
8
  attribute :mcp_request
9
9
  attribute :user
10
+ attribute :agent_turn
10
11
  def user
11
12
  super || session&.user
12
13
  end
@@ -0,0 +1,62 @@
1
+ module Collavre
2
+ class LlmModel < ApplicationRecord
3
+ MAX_SUGGESTIONS = 100
4
+ MAX_VENDOR_LENGTH = 255
5
+ MAX_NAME_LENGTH = 255
6
+ DEFAULT_SUGGESTIONS = [
7
+ [ "cli_proxy", "paperclip/codex_custom/anthropic/claude-sonnet-4.5" ],
8
+ [ "cli_proxy", "paperclip/codex_custom/openai/gpt-5" ]
9
+ ].freeze
10
+
11
+ self.table_name = "llm_models"
12
+
13
+ belongs_to :creator,
14
+ class_name: "Collavre::User",
15
+ foreign_key: :created_by_id,
16
+ optional: true,
17
+ inverse_of: :created_llm_models
18
+
19
+ normalizes :llm_vendor, with: ->(vendor) { vendor.to_s.strip.downcase }
20
+ normalizes :name, with: ->(name) { name.to_s.strip }
21
+
22
+ validates :llm_vendor, presence: true, length: { maximum: MAX_VENDOR_LENGTH }
23
+ validates :name,
24
+ presence: true,
25
+ length: { maximum: MAX_NAME_LENGTH },
26
+ uniqueness: { scope: :llm_vendor }
27
+
28
+ scope :ordered, -> { order(:llm_vendor, :name) }
29
+ scope :suggestions, -> {
30
+ recent_ids = reorder(updated_at: :desc, id: :desc).limit(MAX_SUGGESTIONS).select(:id)
31
+ where(id: recent_ids).ordered
32
+ }
33
+
34
+ def self.remember!(vendor:, name:, creator: nil)
35
+ vendor = vendor.to_s.strip.downcase
36
+ name = name.to_s.strip
37
+ return if vendor.blank? || name.blank?
38
+
39
+ model = find_or_create_by!(llm_vendor: vendor, name: name) do |record|
40
+ record.creator = creator
41
+ end
42
+ model.touch unless model.previously_new_record?
43
+ prune_excess!
44
+ model
45
+ rescue ActiveRecord::RecordNotUnique
46
+ model = find_by!(llm_vendor: vendor, name: name)
47
+ model.touch
48
+ prune_excess!
49
+ model
50
+ end
51
+
52
+ def self.seed_default_suggestions!
53
+ DEFAULT_SUGGESTIONS.each { |vendor, name| remember!(vendor:, name:) }
54
+ end
55
+
56
+ def self.prune_excess!
57
+ keep_ids = reorder(updated_at: :desc, id: :desc).limit(MAX_SUGGESTIONS).select(:id)
58
+ where.not(id: keep_ids).delete_all
59
+ end
60
+ private_class_method :prune_excess!
61
+ end
62
+ end
@@ -42,6 +42,11 @@ module Collavre
42
42
  # Default LLM request timeout (seconds)
43
43
  DEFAULT_LLM_REQUEST_TIMEOUT_SECONDS = 1800
44
44
 
45
+ # Default wall-clock deadline for one AI agent turn (seconds).
46
+ # A turn is the full LLM -> tools -> LLM loop; llm_request_timeout_seconds
47
+ # bounds only a single request inside it.
48
+ DEFAULT_AI_AGENT_TURN_DEADLINE_SECONDS = 3600
49
+
45
50
  # Default creative display settings (system-wide)
46
51
  DEFAULT_DISPLAY_LEVEL = 6
47
52
  DEFAULT_COMPLETION_MARK = ""
@@ -66,7 +71,7 @@ module Collavre
66
71
  password_reset_rate_limit password_reset_rate_period_minutes
67
72
  api_rate_limit api_rate_period_minutes auth_providers_disabled
68
73
  creatives_login_required home_page_path home_page_path_authenticated default_light_theme_id default_dark_theme_id
69
- display_level completion_mark llm_request_timeout_seconds
74
+ display_level completion_mark llm_request_timeout_seconds ai_agent_turn_deadline_seconds
70
75
  ].each { |k| Rails.cache.delete("system_setting:#{k}") }
71
76
  end
72
77
 
@@ -201,5 +206,11 @@ module Collavre
201
206
  value = cached_value("llm_request_timeout_seconds")&.to_i
202
207
  value.nil? || value < 30 ? DEFAULT_LLM_REQUEST_TIMEOUT_SECONDS : value
203
208
  end
209
+
210
+ # AI agent turn wall-clock deadline (seconds)
211
+ def self.ai_agent_turn_deadline_seconds
212
+ value = cached_value("ai_agent_turn_deadline_seconds")&.to_i
213
+ value.nil? || value < 60 ? DEFAULT_AI_AGENT_TURN_DEADLINE_SECONDS : value
214
+ end
204
215
  end
205
216
  end