fuli-context 0.22.0-beta.2 → 0.22.0-beta.4

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 (290) hide show
  1. package/README.md +5 -1
  2. package/README.zh-CN.md +4 -1
  3. package/dist/web/assets/{AboutPage-BsYF7_sz.js → AboutPage-C2Ak6Jii.js} +1 -1
  4. package/dist/web/assets/{AgentHand-C5aUnyp3.js → AgentHand-Cxou5bPl.js} +1 -1
  5. package/dist/web/assets/AgentMentionCopy-BIWsPf22.css +1 -0
  6. package/dist/web/assets/AgentMentionCopy-CibgcJTC.js +1 -0
  7. package/dist/web/assets/{AgentName-DcR-yXAg.js → AgentName-CrIgUC1K.js} +1 -1
  8. package/dist/web/assets/{AgentProfilePage-Cu7q_7eQ.js → AgentProfilePage-ffwdNhMX.js} +1 -1
  9. package/dist/web/assets/AgentServicesPage-CB6IUOrP.css +1 -0
  10. package/dist/web/assets/{AgentServicesPage-KuM8Gh2-.js → AgentServicesPage-D1_fa1SC.js} +1 -1
  11. package/dist/web/assets/{AgentsDirectoryPage-ColciWpR.css → AgentsDirectoryPage-Cq1z926q.css} +1 -1
  12. package/dist/web/assets/AgentsDirectoryPage-SgbPuztQ.js +1 -0
  13. package/dist/web/assets/{BackLink-plP8tjp9.js → BackLink-BrzA4htj.js} +1 -1
  14. package/dist/web/assets/BoardMoveMenu-DgPJT8s1.js +1 -0
  15. package/dist/web/assets/{CaptureChangePage-BV0LJpm1.js → CaptureChangePage-bCYtY611.js} +1 -1
  16. package/dist/web/assets/{Card-B9fEjzdx.js → Card-Zhpf1co5.js} +1 -1
  17. package/dist/web/assets/{CardHeader-iTzyVlAg.js → CardHeader-C9JtHZXs.js} +1 -1
  18. package/dist/web/assets/{CardTitle-Dq4vYfDe.js → CardTitle-B8HEul5N.js} +1 -1
  19. package/dist/web/assets/{ConnectionsPage-CMVrntwM.js → ConnectionsPage-CSWl_R-1.js} +1 -1
  20. package/dist/web/assets/{CreateProjectDialog-dGfGAGgo.js → CreateProjectDialog-CApQ6Yzi.js} +1 -1
  21. package/dist/web/assets/DataFormatPage-DmCKskrj.css +1 -0
  22. package/dist/web/assets/DataFormatPage-Mrr5EvW-.js +2 -0
  23. package/dist/web/assets/{DialogFooter-BwqCbMpI.js → DialogFooter-CRWvDbVh.js} +1 -1
  24. package/dist/web/assets/EmployeeScopeDialog-Brpg45xh.js +1 -0
  25. package/dist/web/assets/EmployeeScopeDialog-CBexPEM7.css +1 -0
  26. package/dist/web/assets/EmployeeWorkbenchPage-7cyTmiY7.js +3 -0
  27. package/dist/web/assets/{EmployeeWorkbenchPage-CmNwqk91.css → EmployeeWorkbenchPage-BFVC_klR.css} +1 -1
  28. package/dist/web/assets/FieldDescription-C1ZURDEJ.js +1 -0
  29. package/dist/web/assets/{GrowthLoading-CL1dGObg.js → GrowthLoading-DnSjbwAi.js} +1 -1
  30. package/dist/web/assets/{InboxPage-DrgE7gQu.js → InboxPage-mwimM5mD.js} +1 -1
  31. package/dist/web/assets/Input-B45GFhbM.js +1 -0
  32. package/dist/web/assets/KnowledgeHardDeleteSection-BaJhsOxD.js +1 -0
  33. package/dist/web/assets/KnowledgeItemEditPage-BpnyOFSx.js +1 -0
  34. package/dist/web/assets/{KnowledgeItemSummaryCard-Bd0Ml6Ia.js → KnowledgeItemSummaryCard-0N1WaM7k.js} +1 -1
  35. package/dist/web/assets/KnowledgeOrganizerPage-CCBudWpM.js +1 -0
  36. package/dist/web/assets/KnowledgeOrganizerPage-D2VWOi81.css +1 -0
  37. package/dist/web/assets/KnowledgePage-DXibFNna.js +1 -0
  38. package/dist/web/assets/KnowledgePeek-B9r1G3ix.js +1 -0
  39. package/dist/web/assets/{KnowledgeTurnReceiptPage-DTZckYql.js → KnowledgeTurnReceiptPage-D4c47u_s.js} +1 -1
  40. package/dist/web/assets/KnowledgeWorkspace-CA8oxVht.css +1 -0
  41. package/dist/web/assets/KnowledgeWorkspace-CJmm-Xs7.js +4 -0
  42. package/dist/web/assets/Label-CBRsKlFL.js +1 -0
  43. package/dist/web/assets/ModelSettingsPage-CeEp6z6R.js +1 -0
  44. package/dist/web/assets/{ModelSettingsPage-Ce3DK7EY.css → ModelSettingsPage-Yx5VBioo.css} +1 -1
  45. package/dist/web/assets/{NotFoundPage--X4xZoMR.js → NotFoundPage-CWfYMNhr.js} +1 -1
  46. package/dist/web/assets/{OccupationsPage-DKuRfjeQ.js → OccupationsPage-BEbQ19dD.js} +1 -1
  47. package/dist/web/assets/OverviewPage-BIDy1btk.css +1 -0
  48. package/dist/web/assets/OverviewPage-Dg3wnb1d.js +2 -0
  49. package/dist/web/assets/PersonalProfilePage-1N8EhCW6.css +1 -0
  50. package/dist/web/assets/{PersonalProfilePage-DgveAPjq.js → PersonalProfilePage-CLD5CnhQ.js} +1 -1
  51. package/dist/web/assets/{PersonalProjectsPage-DJ1VBf1r.js → PersonalProjectsPage-Dcbgmfi_.js} +1 -1
  52. package/dist/web/assets/PopperContent-CESNmYJq.js +1 -0
  53. package/dist/web/assets/Presence-DXkWbJEH.js +3 -0
  54. package/dist/web/assets/ProjectAgentDetailPage-DA90j4yU.css +1 -0
  55. package/dist/web/assets/ProjectAgentDetailPage-io2UP0of.js +8 -0
  56. package/dist/web/assets/{ProjectAgentDialog-3Abm-9sL.js → ProjectAgentDialog-DlzKuGB1.js} +1 -1
  57. package/dist/web/assets/ProjectAgentFirstTask-Dy06Eyzw.js +1 -0
  58. package/dist/web/assets/{ProjectAgentsPage-Cj0PTJAE.js → ProjectAgentsPage-CbUffuyy.js} +1 -1
  59. package/dist/web/assets/{ProjectJudgmentPolicy-9BP_2AkI.js → ProjectJudgmentPolicy-BFx527E9.js} +1 -1
  60. package/dist/web/assets/{ProjectScopePicker-CyZZQW4d.js → ProjectScopePicker-Cqk9DQKF.js} +1 -1
  61. package/dist/web/assets/{PublicProjectsPage-Te3uZA-M.js → PublicProjectsPage-W3CZmgxE.js} +1 -1
  62. package/dist/web/assets/RadioGroupItem-4VcuuIZK.js +1 -0
  63. package/dist/web/assets/RoundtablesPage-BvfBQcJ7.js +1 -0
  64. package/dist/web/assets/RoundtablesPage-EReKCqSf.css +1 -0
  65. package/dist/web/assets/RovingFocusGroup-DyLR4_0m.js +1 -0
  66. package/dist/web/assets/RovingFocusItem-CkXsXOwz.js +1 -0
  67. package/dist/web/assets/SessionMigrationPage-elCVaNnK.js +1 -0
  68. package/dist/web/assets/{SessionRecordsPage-DthAYkM5.js → SessionRecordsPage-CgTk9zqc.js} +1 -1
  69. package/dist/web/assets/SettingsPage-9AMTjLAu.js +1 -0
  70. package/dist/web/assets/{SettingsPage-DQMUQGfr.css → SettingsPage-DpVeP2OZ.css} +1 -1
  71. package/dist/web/assets/SharedJefaReportPage-CViBxD_v.js +1 -0
  72. package/dist/web/assets/SharedJefaReportPage-ROvh2rjx.css +1 -0
  73. package/dist/web/assets/{TableHeader-D7hfNBTs.js → TableHeader-B6al55kg.js} +1 -1
  74. package/dist/web/assets/TabsContent-C6fnXu6I.js +1 -0
  75. package/dist/web/assets/TabsTrigger-CIQwVltR.js +1 -0
  76. package/dist/web/assets/TagVocabularyPage-D88AyXKA.js +1 -0
  77. package/dist/web/assets/TaskBlockerClear-B_xAPoLz.js +1 -0
  78. package/dist/web/assets/TaskBlockerClear-CjSNfpyP.css +1 -0
  79. package/dist/web/assets/TaskBlockerNotice-B3PHEmtC.js +1 -0
  80. package/dist/web/assets/TaskBlockerNotice-CZkho0TF.css +1 -0
  81. package/dist/web/assets/{TaskExecutionPlan-BeP4gm5O.js → TaskExecutionPlan-CVcrXGM8.js} +1 -1
  82. package/dist/web/assets/TaskReason-LleXL19i.css +1 -0
  83. package/dist/web/assets/TaskReason-TdaOCf7S.js +1 -0
  84. package/dist/web/assets/Teleport-DQmFiMAU.js +1 -0
  85. package/dist/web/assets/{TextField-CKNwSQVb.js → TextField-BdQdL1Lx.js} +1 -1
  86. package/dist/web/assets/Textarea-CnjoFPB6.js +1 -0
  87. package/dist/web/assets/UiChip-CILP7dOO.js +1 -0
  88. package/dist/web/assets/UiChip-DulygSq8.css +1 -0
  89. package/dist/web/assets/{UiDialog-BAd1JUvO.js → UiDialog-BIxwydDu.js} +1 -1
  90. package/dist/web/assets/{UiDisclosure-DVZdIuCs.js → UiDisclosure-SMhU3tcV.js} +1 -1
  91. package/dist/web/assets/UiIcon-BPTz4pnL.js +1 -0
  92. package/dist/web/assets/{UiIconButton-W1WfC7dt.js → UiIconButton-jmIfQNdm.js} +1 -1
  93. package/dist/web/assets/UiNotice-DsJRHRTA.js +1 -0
  94. package/dist/web/assets/UiNotice-ZCBdABdM.css +1 -0
  95. package/dist/web/assets/{UiSegmented-Csh7hHda.js → UiSegmented-D-dME5Lr.js} +1 -1
  96. package/dist/web/assets/{UiSelect-Db8o-PRU.js → UiSelect-B7p9uzs4.js} +1 -1
  97. package/dist/web/assets/UiSelect-fhrGABzy.css +1 -0
  98. package/dist/web/assets/{UiToggle-DMuBZLY-.js → UiToggle-Bkg9nRN4.js} +1 -1
  99. package/dist/web/assets/{UiWeight-CfhzKts0.js → UiWeight-B_8vlc3_.js} +1 -1
  100. package/dist/web/assets/UiWeight-qaDd9Wax.css +1 -0
  101. package/dist/web/assets/{UnassignedConversationsPanel-DWUCNfR_.js → UnassignedConversationsPanel-BGrKUSEX.js} +1 -1
  102. package/dist/web/assets/VirtualDirectoryList-1vLi41SD.css +1 -0
  103. package/dist/web/assets/VirtualDirectoryList-B_L9kwcm.js +1 -0
  104. package/dist/web/assets/VisuallyHiddenInput-BHE2kO_O.js +1 -0
  105. package/dist/web/assets/{Workbench3D-DZZDfj10.js → Workbench3D-Doh6x9Ot.js} +1 -1
  106. package/dist/web/assets/_plugin-vue_export-helper-Be38Jawd.js +10 -0
  107. package/dist/web/assets/accordion-B2ZGR46D.js +1 -0
  108. package/dist/web/assets/{agent-pins-O8E8apGs.js → agent-pins-CJDVKD1Y.js} +1 -1
  109. package/dist/web/assets/agent-profile-D4aymIbD.css +1 -0
  110. package/dist/web/assets/agent-profile.css_vue_type_style_index_0_src_true_lang-W7mMZ3bu.js +1 -0
  111. package/dist/web/assets/{agent-roster-records-D13CvTqR.js → agent-roster-records-DGNNHsa3.js} +1 -1
  112. package/dist/web/assets/{agent-work-summary-BM2HS3g8.js → agent-work-summary-CbZjWLGE.js} +1 -1
  113. package/dist/web/assets/{attach-closest-edge-u1fTT6hT.js → attach-closest-edge-B0bgWmui.js} +1 -1
  114. package/dist/web/assets/{attention-store-Dexy6ybk.js → attention-store-BklrG2I7.js} +1 -1
  115. package/dist/web/assets/{badge-DvKUKtfP.js → badge-G1xmTvLV.js} +1 -1
  116. package/dist/web/assets/{button-C1iW0ZW7.js → button-Xb0cKhdr.js} +1 -1
  117. package/dist/web/assets/checkbox-CZg0Iow1.js +1 -0
  118. package/dist/web/assets/{client-CrxcG5dV.js → client-CJGUYN1M.js} +1 -1
  119. package/dist/web/assets/{client-links-store-CrSwWuAU.js → client-links-store-HoGAJb4t.js} +1 -1
  120. package/dist/web/assets/{console-DQ5fV3T8.js → console-Cnye1IOw.js} +1 -1
  121. package/dist/web/assets/{conversation-launcher-settings-Bd222WX0.js → conversation-launcher-settings-BmsEEQjr.js} +1 -1
  122. package/dist/web/assets/{design-lab-B9QfdWfU.js → design-lab-B9JU_TOQ.js} +1 -1
  123. package/dist/web/assets/dialog-CWJVMpu3.js +1 -0
  124. package/dist/web/assets/{dist-Cox3qxin.js → dist-lEETOIok.js} +1 -1
  125. package/dist/web/assets/dropdown-menu-DVE0b7Uc.js +1 -0
  126. package/dist/web/assets/field-ZZ-C7-wp.js +1 -0
  127. package/dist/web/assets/{identity-GQWezGWB.js → identity-wHyBLirA.js} +1 -1
  128. package/dist/web/assets/index-BWziNfHB.js +2 -0
  129. package/dist/web/assets/index-DuLqKIn8.css +1 -0
  130. package/dist/web/assets/{judgment-api-BzpDqFDw.js → judgment-api-BwOm0hL8.js} +1 -1
  131. package/dist/web/assets/label-table-DA5V7oXM.js +1 -0
  132. package/dist/web/assets/model-BnIF0iqb.js +1 -0
  133. package/dist/web/assets/{model-T6Jor9oL.js → model-BndkODhT.js} +1 -1
  134. package/dist/web/assets/{model-BeQStl_a.js → model-DdrMcS8b.js} +1 -1
  135. package/dist/web/assets/{model-0znFleoY.js → model-DqILignz.js} +1 -1
  136. package/dist/web/assets/{model-CYXGfox9.js → model-YwLQNm5s.js} +1 -1
  137. package/dist/web/assets/{model-LTc6Nj3z.js → model-cgiHaWsF.js} +1 -1
  138. package/dist/web/assets/{motion-preference-CHiRbvgR.js → motion-preference-D7rorL9a.js} +1 -1
  139. package/dist/web/assets/{occupation-catalog-Caq13-kY.js → occupation-catalog-BG1VjWtG.js} +1 -1
  140. package/dist/web/assets/{orchestration-filters-DSnybvV3.js → orchestration-filters-BKS3yBja.js} +1 -1
  141. package/dist/web/assets/{page-title-BflOskhA.js → page-title-BiSHyu6N.js} +1 -1
  142. package/dist/web/assets/{profile-model-CVx0a_P4.js → profile-model-i36bqqb2.js} +1 -1
  143. package/dist/web/assets/{project-board-layout-DmQActFu.js → project-board-layout-DPItL60Q.js} +1 -1
  144. package/dist/web/assets/{project-capture-H4qMdM1l.js → project-capture-CFeMGS5O.js} +1 -1
  145. package/dist/web/assets/{project-origin-DMR9fKUE.js → project-origin-wTTsd0pp.js} +1 -1
  146. package/dist/web/assets/project-team-api-BrC4ewpy.js +1 -0
  147. package/dist/web/assets/{quick-edit-api-CCaH3tbK.js → quick-edit-api-BbKWyjWy.js} +1 -1
  148. package/dist/web/assets/select-DrMXPnfK.js +1 -0
  149. package/dist/web/assets/shared-report-D6AgVQoO.js +3 -0
  150. package/dist/web/assets/{task-evidence-M32pNYH0.js → task-evidence-B2smSxDg.js} +1 -1
  151. package/dist/web/assets/task-labels-CIzXKt-p.js +1 -0
  152. package/dist/web/assets/ui-CwdCReAf.css +1 -0
  153. package/dist/web/assets/ui-D936HGK2.js +1 -0
  154. package/dist/web/assets/{useAgentRecords-3-zWyxUu.js → useAgentRecords-V5t2SdoJ.js} +1 -1
  155. package/dist/web/assets/{useApi-CROJJdhE-Cm-N4N7-.js → useApi-CROJJdhE-BUho7jmG.js} +1 -1
  156. package/dist/web/assets/useDirection-C0EDWveN.js +1 -0
  157. package/dist/web/assets/{useFocusReturn-Dq-yqBLj.js → useFocusReturn-DaWUYyV8.js} +1 -1
  158. package/dist/web/assets/useForwardExpose-BW43swEH.js +1 -0
  159. package/dist/web/assets/{useKnowledgeItemPeek-BWbdLqAL.js → useKnowledgeItemPeek-BJBUG0nY.js} +1 -1
  160. package/dist/web/assets/{useMinimumLoadingDisplay-BEUl4UAV.js → useMinimumLoadingDisplay-DT1pktOl.js} +1 -1
  161. package/dist/web/assets/{useRoutePeek-C_9DVOKT.js → useRoutePeek-dXJW_jIl.js} +1 -1
  162. package/dist/web/assets/{useTypeahead-CP74zC2e.js → useTypeahead-BVDZWCri.js} +1 -1
  163. package/dist/web/assets/utils-BTTEEOG-.js +1 -0
  164. package/dist/web/assets/{vue-router-rg-hudCL.js → vue-router-DMMH71_5.js} +1 -1
  165. package/dist/web/index.html +46 -41
  166. package/docs/agent-interface-architecture.md +14 -4
  167. package/graph-provider/fuli_graph/app.py +1 -1
  168. package/graph-provider/fuli_graph/graph_field_contract.py +1 -1
  169. package/graph-provider/fuli_graph/graph_format_migrations.py +10 -1
  170. package/graph-provider/fuli_graph/project_agent_names.py +29 -5
  171. package/graph-provider/fuli_graph/project_agent_routes.py +16 -0
  172. package/graph-provider/fuli_graph/project_agent_task_models.py +14 -3
  173. package/graph-provider/fuli_graph/runtime.py +7 -0
  174. package/graph-provider/fuli_graph/store_project_agent_naming.py +33 -6
  175. package/graph-provider/fuli_graph/store_project_agent_task_blockers.py +42 -7
  176. package/graph-provider/fuli_graph/store_project_agent_task_reads.py +2 -1
  177. package/graph-provider/fuli_graph/store_project_agent_tasks.py +3 -0
  178. package/graph-provider/fuli_graph/store_project_agents.py +1 -1
  179. package/graph-provider/fuli_graph/task_blocker.py +11 -0
  180. package/graph-provider/pyproject.toml +1 -1
  181. package/native/win32/fuli-win-helper.exe +0 -0
  182. package/npm-shrinkwrap.json +2 -2
  183. package/package.json +1 -1
  184. package/skills/capturing-session-knowledge/references/coordination.md +6 -2
  185. package/skills/operating-fuli/references/workflow-recipes.md +2 -1
  186. package/src/agent-apps/host-tools/catalog.js +1 -0
  187. package/src/agent-naming/naming-style.js +30 -0
  188. package/src/agent-tools/graph-handlers.js +7 -0
  189. package/src/agent-tools/interface-catalog.js +2 -0
  190. package/src/agent-tools/project-agent-definitions.js +4 -1
  191. package/src/agent-tools/project-agent-tool-definitions.js +6 -0
  192. package/src/cli/native-runtime-command.js +1 -0
  193. package/src/desktop/windows-controller.js +39 -6
  194. package/src/desktop/windows-installation-switch.js +16 -6
  195. package/src/desktop/windows-update-command.js +2 -0
  196. package/src/desktop/windows-update-runtime.js +28 -3
  197. package/src/desktop/windows-update.js +9 -9
  198. package/src/graphiti/federated-application.js +1 -0
  199. package/src/graphiti/project-agent-mapping.js +1 -0
  200. package/src/http/api-router.js +3 -0
  201. package/src/http/task-blocker-api-router.js +35 -0
  202. package/src/local-runtime/child-process-log.js +34 -0
  203. package/src/mcp/tool-annotations.js +1 -0
  204. package/src/native-runtime/neo4j-asset-state.js +4 -3
  205. package/src/native-runtime/neo4j-lifecycle.js +43 -18
  206. package/src/native-runtime/neo4j-version-policy.js +28 -0
  207. package/src/native-runtime/runtime.js +14 -12
  208. package/src/native-runtime/windows-processes.js +3 -3
  209. package/src/presence/windows-helper-pin.js +1 -1
  210. package/src/server.js +7 -0
  211. package/src/setup/graph-runtime.js +9 -7
  212. package/src/setup/paths.js +7 -1
  213. package/src/setup/setup.js +11 -1
  214. package/src/system/console-port-switch.js +42 -0
  215. package/src/system/reserved-ports.js +111 -0
  216. package/src/system/runtime-settings.js +6 -2
  217. package/src/system/settings-apply.js +6 -6
  218. package/src/system/settings-guide.js +7 -0
  219. package/src/system/system-service.js +2 -1
  220. package/src/task-blockers/console-port.js +20 -0
  221. package/dist/web/assets/AgentMentionCopy-CTVGHbLe.js +0 -1
  222. package/dist/web/assets/AgentMentionCopy-Dv5izHzv.css +0 -1
  223. package/dist/web/assets/AgentServicesPage-KPgp3aqp.css +0 -1
  224. package/dist/web/assets/AgentsDirectoryPage-9YEOf4nL.js +0 -1
  225. package/dist/web/assets/BoardMoveMenu-DC6_givs.js +0 -1
  226. package/dist/web/assets/DataFormatPage-BwjmmNgj.css +0 -1
  227. package/dist/web/assets/DataFormatPage-DuEma4K0.js +0 -2
  228. package/dist/web/assets/EmployeeScopeDialog-BoVOcccy.js +0 -1
  229. package/dist/web/assets/EmployeeScopeDialog-DkqAe9sJ.css +0 -1
  230. package/dist/web/assets/EmployeeWorkbenchPage-_h6-ZFHV.js +0 -3
  231. package/dist/web/assets/Input-14C6kRsv.js +0 -1
  232. package/dist/web/assets/KnowledgeHardDeleteSection-DYD4BeL_.js +0 -1
  233. package/dist/web/assets/KnowledgeItemEditPage-Cja2_OMd.js +0 -1
  234. package/dist/web/assets/KnowledgeOrganizerPage-BIOaMzgQ.css +0 -1
  235. package/dist/web/assets/KnowledgeOrganizerPage-MT3tMGVx.js +0 -1
  236. package/dist/web/assets/KnowledgePage-bWItlXy5.js +0 -1
  237. package/dist/web/assets/KnowledgePeek-Cj9AiG_J.js +0 -1
  238. package/dist/web/assets/KnowledgeWorkspace-BOrKazVl.js +0 -4
  239. package/dist/web/assets/KnowledgeWorkspace-bhlGz1Mr.css +0 -1
  240. package/dist/web/assets/Label-WCfl_UpK.js +0 -1
  241. package/dist/web/assets/ModelSettingsPage-CQZdCaiX.js +0 -1
  242. package/dist/web/assets/OverviewPage-B2sbgaT-.js +0 -2
  243. package/dist/web/assets/OverviewPage-C2ao6sX6.css +0 -1
  244. package/dist/web/assets/PersonalProfilePage-KJvkIuAm.css +0 -1
  245. package/dist/web/assets/PopperContent-DgnpW6vB.js +0 -1
  246. package/dist/web/assets/Presence-Bn4pKveC.js +0 -3
  247. package/dist/web/assets/ProjectAgentDetailPage-BSBpu2sZ.css +0 -1
  248. package/dist/web/assets/ProjectAgentDetailPage-CH57mPoo.js +0 -8
  249. package/dist/web/assets/ProjectAgentFirstTask-CLQFOwXi.js +0 -1
  250. package/dist/web/assets/RadioGroupItem-CZvh557X.js +0 -1
  251. package/dist/web/assets/RoundtablesPage-CxjA1cGF.css +0 -1
  252. package/dist/web/assets/RoundtablesPage-D0LICyzx.js +0 -1
  253. package/dist/web/assets/RovingFocusGroup-CKuSV66n.js +0 -1
  254. package/dist/web/assets/RovingFocusItem-D6DzRzcZ.js +0 -1
  255. package/dist/web/assets/SessionMigrationPage-CEP1Mr9n.js +0 -1
  256. package/dist/web/assets/SettingsPage-BtJ3O9ZH.js +0 -1
  257. package/dist/web/assets/SharedJefaReportPage-2VMoiCJj.js +0 -1
  258. package/dist/web/assets/SharedJefaReportPage-CcD-06mK.css +0 -1
  259. package/dist/web/assets/TabsContent-vZY5Gjt-.js +0 -1
  260. package/dist/web/assets/TabsTrigger-Dhi51wTn.js +0 -1
  261. package/dist/web/assets/TagVocabularyPage-CLe5HBs6.js +0 -1
  262. package/dist/web/assets/TaskBlockerNotice-CIVFwBgZ.css +0 -1
  263. package/dist/web/assets/TaskBlockerNotice-DgJBUFNl.js +0 -1
  264. package/dist/web/assets/Teleport-ByKM5w1b.js +0 -1
  265. package/dist/web/assets/Textarea-Ca7nOquD.js +0 -1
  266. package/dist/web/assets/UiIcon-DOwSNz_e.js +0 -1
  267. package/dist/web/assets/UiSelect-CiSPw-7k.css +0 -1
  268. package/dist/web/assets/UiWeight-aUNtanHz.css +0 -1
  269. package/dist/web/assets/VirtualDirectoryList-BpYcDx5H.js +0 -1
  270. package/dist/web/assets/VirtualDirectoryList-pgDELOEf.css +0 -1
  271. package/dist/web/assets/VisuallyHiddenInput-BEz-QHu_.js +0 -1
  272. package/dist/web/assets/_plugin-vue_export-helper-C98j5XpL.js +0 -10
  273. package/dist/web/assets/accordion-BqNFYBeR.js +0 -1
  274. package/dist/web/assets/agent-profile-DSeJwkEw.css +0 -1
  275. package/dist/web/assets/agent-profile.css_vue_type_style_index_0_src_true_lang-cZYEJ_8z.js +0 -1
  276. package/dist/web/assets/checkbox-BIMU57_g.js +0 -1
  277. package/dist/web/assets/dialog-DFkjUY8h.js +0 -1
  278. package/dist/web/assets/dropdown-menu-BF3zRtMG.js +0 -1
  279. package/dist/web/assets/field-CG5pHJks.js +0 -1
  280. package/dist/web/assets/index-Di5_eD7U.js +0 -2
  281. package/dist/web/assets/index-Dktlia0_.css +0 -1
  282. package/dist/web/assets/model-DRuw3_ym.js +0 -1
  283. package/dist/web/assets/project-team-api-CBnMg8k5.js +0 -1
  284. package/dist/web/assets/select-C369n9Ru.js +0 -1
  285. package/dist/web/assets/shared-report-DO2Khr8D.js +0 -3
  286. package/dist/web/assets/task-labels-BRZad3HE.js +0 -1
  287. package/dist/web/assets/ui-CRfyX0ED.css +0 -1
  288. package/dist/web/assets/ui-DieLnn9C.js +0 -1
  289. package/dist/web/assets/useDirection-BGtNSPCf.js +0 -1
  290. package/dist/web/assets/utils-DDDNAHy1.js +0 -1
@@ -7,6 +7,7 @@ import { refusedAgentWriteNotice } from '../graphiti/capture-notice.js';
7
7
  import { isTagGovernanceProposal, knowledgeTagChange, proposeTagGovernance } from '../graphiti/knowledge-tags.js';
8
8
  import { prepareKnowledgeRecovery } from '../knowledge-hard-delete/recovery-gate.js';
9
9
  import { reportAgentService } from '../agent-services/agent-report.js';
10
+ import { agentNamingStyleAnswer } from '../agent-naming/naming-style.js';
10
11
 
11
12
  // These tools read or change the two local stores that can retain deleted
12
13
  // knowledge. Provider-only reads and unrelated tools remain available.
@@ -54,6 +55,7 @@ const HANDLERS = Object.freeze({
54
55
  // The caller's own session only, in its own project (rec#5 C6-5).
55
56
  read_session_records: (app, input) => app.readOwnSessionRecords(input ?? {}),
56
57
  explain_settings: (app) => settingsGuide(app),
58
+ get_agent_naming_style: (app) => agentNamingStyle(app),
57
59
  // sessionPaused pauses or resumes only the caller's session, at once. Every
58
60
  // other field is a long-term setting an Agent can only ask for: the person
59
61
  // confirms it in the console (rec#5 C4-2, rec#11 D-16). The client is this
@@ -311,6 +313,11 @@ function settingsGuide(app) {
311
313
  return app.explainSettings();
312
314
  }
313
315
 
316
+ function agentNamingStyle(app) {
317
+ if (!app.agentNamingStyle) throw new Error('Settings are unavailable without a local installation');
318
+ return agentNamingStyleAnswer(app.agentNamingStyle());
319
+ }
320
+
314
321
  function externalKnowledge(app) {
315
322
  if (!app.externalKnowledge) throw new Error('External knowledge runtime is unavailable');
316
323
  return app.externalKnowledge;
@@ -68,6 +68,7 @@ const UI_MUTATION_PARITY = Object.freeze([
68
68
  agent('POST /api/project-agent-tasks', 'submit_project_agent_task'),
69
69
  agent('POST /api/project-agent-tasks/:taskId/runs/:runId/stop', 'control_project_agent_task_run'),
70
70
  agent('POST /api/project-agent-tasks/:taskId/retry', 'control_project_agent_task_run'),
71
+ local('POST /api/project-agent-tasks/:taskId/blocker/clear', 'Marking a blocked task as unblocked (标记为已解除) is the person\'s word that the block is resolved outside FULI; they do it in the console on the human-review channel. An Agent clears its own block only by continuing in the session that reported it.'),
71
72
  local('POST /api/standing-assignments/:assignmentId/retire', 'Ending a standing assignment in the console is the local person\'s action on the record they read; in a conversation an Agent previews it with register_standing_assignment and confirms only after the person\'s yes (rec#29 F5).'),
72
73
  local('POST /api/standing-assignments/:assignmentId/reassign', 'Pointing a standing assignment at another Agent or project in the console is the local person\'s action; in a conversation an Agent previews it with register_standing_assignment and confirms only after the person\'s yes.'),
73
74
  local('POST /api/standing-assignments/:assignmentId/terms', 'Editing a standing assignment\'s terms in the console is the local person\'s action; in a conversation an Agent previews it with register_standing_assignment and confirms only after the person\'s yes.'),
@@ -150,6 +151,7 @@ export function agentInterfaceCatalog() {
150
151
  { domain: 'knowledge', toolNames: ['search_knowledge_graph', 'get_knowledge_graph', 'get_user_taste_skill', 'list_preference_conflicts'] },
151
152
  { domain: 'knowledge-tags', toolNames: ['resolve_knowledge_tags'], readRoutes: ['GET /api/knowledge-tags', 'GET /api/knowledge-tags/metrics'], guidance: 'Resolve before creating. Reuse an exact or alias match; similar is a candidate only. Make a synonym reuse a tag with add_alias, never a second tag. A merged tag\'s ID and words lead to the tag it went into. Tags organize retrieval; they never grant access or confirm knowledge; only the person merges, splits, approves or retires them.' },
152
153
  { domain: 'people-and-tasks', toolNames: ['get_project_team', 'list_project_agents', 'list_project_agent_assignments', 'list_project_agent_tasks', 'view_project_agent_task', 'view_project_agent_activity', 'list_project_agent_recruitments'], guidance: 'After @FLG … 一起看 (task entry flg.status together), flg.context indexes only the confirmed members: read a full task with view_project_agent_task and knowledge with search_current_project_knowledge for that member\'s project. Read-only: never change their tasks or assignments, and never read another FLA\'s working memory with get_project_agent_memory; it stays private to that FLA.' },
154
+ { domain: 'agent-naming', toolNames: ['get_agent_naming_style'], readRoutes: ['GET /api/system/settings'], guidance: 'Read the person\'s naming style right before proposing a new Agent\'s displayName. Only the person sets, edits or clears it in settings (PUT /api/system/settings is local_user_only). A taken name is refused with free names; existing Agents are never renamed to fit a style.' },
153
155
  { domain: 'agent-dismissal', toolNames: ['list_agent_dismissal_lessons', 'get_agent_handoff'], guidance: 'Only Bole dismisses an Agent, with dismiss_project_agent, after the user initiates or approves it and gives the reason. Lessons are looked up on demand by occupation or project; the handoff is read when taking over the work.' },
154
156
  { domain: 'agent-memory', toolNames: ['get_project_agent_memory', 'export_project_agent_memory'], readRoutes: ['GET /api/project-agents/:agentId/memory', 'GET /api/project-agents/:agentId/memory/export'], guidance: 'Export returns generated Markdown for one scope from a fresh database read. The database stays authoritative; edited exports or directory files are never imported. Change memory with checkpoint_project_agent_memory.' },
155
157
  { domain: 'roundtable', toolNames: ['find_agents', 'agent_chat', 'read_agent_messages', 'read_agent_thread', 'get_agent_message_status'], readRoutes: ['GET /api/roundtable/agents', 'GET /api/roundtable/chats', 'GET /api/roundtable/chats/:chatId', 'GET /api/roundtable/threads', 'GET /api/roundtable/threads/:threadId', 'GET /api/roundtable/messages/:messageId'], guidance: 'agent_chat is pure member-scoped direct/group communication; use after/limit to page messages and afterChat/transport to page local or peer rooms. Creation and sends require stable request IDs; membership edits require the current revision. No chat grants execution, memory access or knowledge weight. Pairing and explicit shares remain owner actions. message_agent is the separate execution path, limited to shared remote project leads. Unknown execution may have run and is not retried. A reply is not evidence of execution or human approval. When task entry returns requested_agent_id, keep the selected Agent identity and follow requested_agent_guidance.' },
@@ -54,7 +54,10 @@ export const projectAgentModelStrategy = objectSchema({
54
54
  });
55
55
  export const projectAgentProfile = objectSchema({
56
56
  name: boundedString(160),
57
- displayName: boundedString(160),
57
+ displayName: {
58
+ ...boundedString(160),
59
+ description: 'Unique person-like name; for a new Agent follow get_agent_naming_style, or omit to generate one.'
60
+ },
58
61
  responsibility: boundedString(4096),
59
62
  character: {
60
63
  ...objectSchema({
@@ -44,6 +44,12 @@ export const PROJECT_AGENT_TOOL_DEFINITIONS = [
44
44
  occupation: projectAgentOccupation
45
45
  }, ['personalSpaceId', 'agentId', 'profile'])
46
46
  },
47
+ {
48
+ name: 'get_agent_naming_style',
49
+ title: 'READ · Get the Agent naming style',
50
+ description: 'Before proposing a new Agent\'s displayName: the person\'s saved naming style, or null (generated names). Only the person changes it.',
51
+ inputSchema: objectSchema({})
52
+ },
47
53
  {
48
54
  name: 'list_project_agents',
49
55
  title: 'READ · Find project Agents by responsibility',
@@ -29,6 +29,7 @@ export async function runNativeRuntimeCommand(args, dependencies = {}) {
29
29
  const plan = options.action === 'install' ? { neo4jVersion: NATIVE_NEO4J_VERSION }
30
30
  : await (dependencies.plan ?? planNativeNeo4j)({ paths, action: options.action });
31
31
  write(`Native Neo4j ${options.action}: ${plan.neo4jVersion ?? NATIVE_NEO4J_VERSION}\nData: ${paths.dataDir}\nKnowledge data is preserved. Java is not installed or upgraded.`);
32
+ if (plan.upgrade) write(`Neo4j ${plan.current.neo4jVersion} → ${plan.neo4jVersion}: the graph is backed up under ${paths.graphBackupDir} first; rolling back to ${plan.current.neo4jVersion} afterwards is refused.`);
32
33
  if (options.preview) return { status: 'preview', action: options.action, neo4jVersion: plan.neo4jVersion };
33
34
  if (!options.yes && !await (dependencies.confirm ?? confirmAction)(options.action)) return { status: 'cancelled' };
34
35
  const result = options.action === 'install'
@@ -4,11 +4,15 @@ import { existsSync, readFileSync, realpathSync } from 'node:fs';
4
4
  import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
5
5
  import { fileURLToPath } from 'node:url';
6
6
  import { readWindowsNativeBundle } from '../native-runtime/windows-assets.js';
7
+ import { resolveSetupPaths } from '../setup/paths.js';
8
+ import { switchConsolePort } from '../system/console-port-switch.js';
7
9
  import { isMainModule } from '../system/main-module.js';
10
+ import { reservedPortProblem } from '../system/reserved-ports.js';
11
+ import { readRuntimeSettings } from '../system/runtime-settings.js';
8
12
  import { readWindowsInstallation, windowsMigrationCommand } from './windows-installation-context.js';
9
13
 
10
14
  const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
11
- const ACTIONS = new Set(['status', 'start', 'start-open', 'open', 'stop']);
15
+ const ACTIONS = new Set(['status', 'start', 'start-open', 'open', 'stop', 'change-port']);
12
16
  const STATES = new Set(['running', 'stopped', 'degraded', 'not_configured']);
13
17
 
14
18
  function contains(root, path) {
@@ -81,7 +85,16 @@ function assertNativeSelection(context) {
81
85
  }
82
86
  }
83
87
 
84
- export async function runTrayAction(action, context, { runCli = executeCli } = {}) {
88
+ // Whether the selected data's console port is one Windows will not hand out.
89
+ async function consolePortBlocked(context) {
90
+ const settings = readRuntimeSettings(join(context.dataDir, 'runtime-settings.json'));
91
+ return await reservedPortProblem(settings.ports.console, {
92
+ host: settings.lanAccess ? '0.0.0.0' : '127.0.0.1' }) !== null;
93
+ }
94
+
95
+ export async function runTrayAction(action, context, {
96
+ runCli = executeCli, portBlocked = consolePortBlocked, switchPort = switchConsolePort
97
+ } = {}) {
85
98
  if (!ACTIONS.has(action)) throw new Error('Unsupported tray action: ' + action);
86
99
  const invoke = (args) => runCli(context, [...args, '--data-dir', context.dataDir]);
87
100
  const inspect = async () => {
@@ -97,9 +110,26 @@ export async function runTrayAction(action, context, { runCli = executeCli } = {
97
110
  const result = await invoke(args);
98
111
  if (result.code !== 0) throw cliError(result);
99
112
  };
113
+ let starting = false;
114
+ let notice = null;
100
115
  try {
101
- if (['start', 'start-open', 'stop'].includes(action)) assertNativeSelection(context);
116
+ if (['start', 'start-open', 'stop', 'change-port'].includes(action)) assertNativeSelection(context);
117
+ if (action === 'change-port') {
118
+ if (!existsSync(join(context.dataDir, 'graph-runtime.json'))) {
119
+ throw new Error('Fuli 尚未设置,请先「启动并打开」。 / Fuli is not set up yet; use Start and open first.');
120
+ }
121
+ const before = await inspect();
122
+ const switched = await switchPort(resolveSetupPaths({ dataDir: context.dataDir }));
123
+ // Client MCP and hook configurations name the data directory, never a port;
124
+ // a running MCP process keeps the console address it read when it started.
125
+ notice = `已改用端口 ${switched.port}(原 ${switched.previousPort})。已打开的 Agent 会话里的 Fuli 链接仍指向旧地址,重开会话即可更新。`
126
+ + ` / Fuli now uses port ${switched.port} (was ${switched.previousPort}). Fuli links in open Agent sessions point to the old address until those sessions restart.`;
127
+ await command([before.status === 'running' ? 'restart' : 'start']);
128
+ const ready = await inspect();
129
+ if (ready.status !== 'running') throw new Error('Fuli did not reach its running state.');
130
+ }
102
131
  if (action === 'start' || action === 'start-open') {
132
+ starting = true;
103
133
  if (!existsSync(join(context.dataDir, 'graph-runtime.json'))) {
104
134
  await command(['setup', '--yes', '--skip-agents', '--personal-only', '--runtime-mode', 'native']);
105
135
  } else {
@@ -109,20 +139,23 @@ export async function runTrayAction(action, context, { runCli = executeCli } = {
109
139
  const ready = await inspect();
110
140
  if (ready.status !== 'running') throw new Error('Fuli did not reach its running state.');
111
141
  }
112
- if (action === 'open' || action === 'start-open') await command(['open']);
142
+ if (['open', 'start-open', 'change-port'].includes(action)) await command(['open']);
113
143
  if (action === 'stop') await command(['stop']);
114
144
  const state = await inspect();
115
145
  if (action === 'stop' && !['stopped', 'not_configured'].includes(state.status)) {
116
146
  throw new Error('Fuli did not confirm that the selected runtime stopped.');
117
147
  }
118
- return { ok: true, action, status: state.status, label: trayStateLabel(state), state };
148
+ return { ok: true, action, status: state.status, label: trayStateLabel(state), state, ...(notice ? { notice } : {}) };
119
149
  } catch (error) {
120
150
  // A failed start can already own processes. Keep their CLI state and report
121
151
  // what is actually running; never kill by process name or delete the data.
122
152
  const state = await inspect().catch(() => null);
153
+ // A start that failed on a port Windows reserves offers the port change.
154
+ const blocked = starting && await portBlocked(context).catch(() => false);
123
155
  return { ok: false, action, status: state?.status ?? 'unknown',
124
156
  label: state ? trayStateLabel(state) : '状态未知 / Unknown',
125
- state, error: error.message };
157
+ state, error: notice ? `${error.message}\n\n${notice}` : error.message,
158
+ ...(blocked ? { portBlocked: true } : {}) };
126
159
  }
127
160
  }
128
161
 
@@ -4,7 +4,7 @@ import { dirname, join } from 'node:path';
4
4
  import { writeTextFileAtomic } from '../storage/json-file.js';
5
5
  import { canonicalWindowsInstallPath, installationSha256, windowsInstallPathsOverlap } from './windows-installation-context.js';
6
6
  import { stopInstalledFuli } from './windows-running-fuli.js';
7
- import { prepareWindowsUpdateRuntime, restoreWindowsUpdateRuntime } from './windows-update-runtime.js';
7
+ import { backupWindowsGraph, prepareWindowsUpdateRuntime, restoreWindowsUpdateRuntime } from './windows-update-runtime.js';
8
8
 
9
9
  // Switching the installed version: shared by update and user-initiated rollback.
10
10
  // The record and shortcuts change only after the running version has stopped,
@@ -46,7 +46,8 @@ export function stageWindowsShortcuts(shortcuts, packageRoot, createShortcut, re
46
46
  }
47
47
 
48
48
  // stopping: how processes that outlive the installed CLI's stop are handled (windows-running-fuli.js).
49
- export async function stopAndSwitchWindowsInstallation(plan, staged, packageRoot, { runCli, lock, write, discard = () => {}, stopping = {} }) {
49
+ // backupGraph: the graph backup before a Neo4j patch upgrade (windows-update-runtime.js).
50
+ export async function stopAndSwitchWindowsInstallation(plan, staged, packageRoot, { runCli, lock, write, discard = () => {}, stopping = {}, backupGraph = backupWindowsGraph }) {
50
51
  try {
51
52
  lock.assertHeld();
52
53
  assertInstallationUnchanged(plan.recordPath, plan.record);
@@ -58,10 +59,10 @@ export async function stopAndSwitchWindowsInstallation(plan, staged, packageRoot
58
59
  discard();
59
60
  throw error;
60
61
  }
61
- return switchInstallation(plan, staged, packageRoot, runCli, lock, write);
62
+ return switchInstallation(plan, staged, packageRoot, runCli, lock, write, backupGraph);
62
63
  }
63
64
 
64
- async function switchInstallation(plan, staged, packageRoot, runCli, lock, write) {
65
+ async function switchInstallation(plan, staged, packageRoot, runCli, lock, write, backupGraph) {
65
66
  const execute = runCli;
66
67
  runCli = async (...args) => {
67
68
  lock.assertHeld();
@@ -70,6 +71,9 @@ async function switchInstallation(plan, staged, packageRoot, runCli, lock, write
70
71
  return result;
71
72
  };
72
73
  const { current } = plan;
74
+ const upgrade = staged.runtime.neo4jUpgrade;
75
+ // After the newer Neo4j opened the store, the older one might not open it again.
76
+ const kept = () => upgrade ? ` The graph backup taken before Neo4j ${upgrade.to} is kept at ${upgrade.backupDir}.` : '';
73
77
  const args = command => [command, '--data-dir', current.dataDir];
74
78
  // A confirmed downgrade lets the new version replace the recorded Provider.
75
79
  const startArgs = () => plan.downgrade ? [...args('start'), '--allow-provider-downgrade'] : args('start');
@@ -79,6 +83,12 @@ async function switchInstallation(plan, staged, packageRoot, runCli, lock, write
79
83
  lock.assertHeld();
80
84
  assertInstallationUnchanged(plan.recordPath, plan.record);
81
85
  for (const shortcut of plan.shortcuts) assertInstallationUnchanged(shortcut.path, shortcut.bytes);
86
+ if (upgrade) {
87
+ write(`Backing up the graph before upgrading Neo4j ${upgrade.from} → ${upgrade.to}...`);
88
+ try { await backupGraph(staged.runtime, current); }
89
+ catch (error) { throw new Error('The graph backup before the Neo4j upgrade failed; nothing was switched.', { cause: error }); }
90
+ lock.assertHeld();
91
+ }
82
92
  prepareWindowsUpdateRuntime(staged.runtime);
83
93
  writeTextFileAtomic(plan.recordPath, staged.record);
84
94
  switched = true;
@@ -111,8 +121,8 @@ async function switchInstallation(plan, staged, packageRoot, runCli, lock, write
111
121
  await requireInstalledCli(runCli, current.packageRoot, args('start'), 'The previous Fuli did not start again.');
112
122
  await requireInstalledCli(runCli, current.packageRoot, args('status'), 'The previous Fuli did not report a running state.');
113
123
  } catch (caught) { failures.push(caught); }
114
- if (failures.length) throw new AggregateError([error, ...failures], 'Rollback needs attention: ' + failures.map(e => e.message).join('; '));
115
- throw new Error(`${error.message} Fuli ${current.applicationVersion} was restored; the other copy is kept at ${packageRoot}.`, { cause: error });
124
+ if (failures.length) throw new AggregateError([error, ...failures], 'Rollback needs attention: ' + failures.map(e => e.message).join('; ') + (started ? kept() : ''));
125
+ throw new Error(`${error.message} Fuli ${current.applicationVersion} was restored; the other copy is kept at ${packageRoot}.${started ? kept() : ''}`, { cause: error });
116
126
  }
117
127
  write('Reconnecting already connected Agent clients...');
118
128
  let clients = 'not_reconnected';
@@ -19,6 +19,8 @@ export async function runWindowsUpdateCommand(args = [], dependencies = {}) {
19
19
  const plan = (dependencies.plan ?? planWindowsUpdate)(updateOptions);
20
20
  if (plan.downgrade) write('这是降版替换(--allow-downgrade):程序换成更低的版本号,数据不变;更新前请先备份数据目录。 / This replaces Fuli with a lower version (--allow-downgrade); data is kept. Back up the data folder first.');
21
21
  write(`更新 / Update: ${plan.current.applicationVersion} → ${plan.applicationVersion}\n程序 / Application: ${plan.installRoot}\n保留数据 / Keep data: ${plan.current.dataDir}\n请先退出 Fuli 托盘;服务会自动停止后重启。 / Exit the tray first; services will be stopped and restarted.`);
22
+ const upgrade = plan.neo4jUpgrade;
23
+ if (upgrade) write(`Neo4j ${upgrade.from} → ${upgrade.to}:切换前先备份图谱;升级后不能回退到 ${upgrade.from}。 / The graph is backed up before the switch; rolling back to Neo4j ${upgrade.from} afterwards is refused.`);
22
24
  if (preview) return { status: 'preview' };
23
25
  if (!yes && !await confirm('更新? / Update? [y/N] ')) return { status: 'cancelled' };
24
26
  const stopping = { stopPids, confirmStop: yes ? undefined : async blockers => {
@@ -1,23 +1,48 @@
1
1
  import { existsSync, readFileSync, unlinkSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
+ import { exportGraphData } from '../backup/graph-backup.js';
4
+ import { createGraphBackupAdapter } from '../backup/runtime-adapters.js';
5
+ import { neo4jPatchUpgrade, neo4jUpgradeBackupPath } from '../native-runtime/neo4j-version-policy.js';
3
6
  import { readWindowsNativeBundle, resolveWindowsNativeBundle } from '../native-runtime/windows-assets.js';
4
7
  import { compareSemanticVersions } from '../semantic-version.js';
8
+ import { graphBackupDirectory, resolveSetupPaths } from '../setup/paths.js';
5
9
  import { writeTextFileAtomic } from '../storage/json-file.js';
6
10
 
7
11
  // downgrade: an older package refuses a newer runtime descriptor, so the switch
8
12
  // clears it and the older version records its own bundled runtime on start.
9
- export function snapshotWindowsUpdateRuntime(current, candidateRoot, { downgrade = false } = {}) {
13
+ // A newer Neo4j patch in the candidate is an upgrade: the graph is backed up
14
+ // before the newer Neo4j first opens the store (backupWindowsGraph). An older
15
+ // one is refused, whichever way the application version goes.
16
+ export function snapshotWindowsUpdateRuntime(current, candidateRoot, { downgrade = false, now = () => new Date() } = {}) {
10
17
  const settingsPath = join(current.dataDir, 'runtime-settings.json');
11
18
  if (!existsSync(settingsPath) || JSON.parse(readFileSync(settingsPath)).graphRuntimeMode !== 'native') {
12
19
  throw new Error('Open the installed Fuli tray and configure native mode before updating. Container data requires a separate migration.');
13
20
  }
14
21
  const assets = root => resolveWindowsNativeBundle(readWindowsNativeBundle(root));
15
22
  const previous = assets(current.packageRoot), next = assets(candidateRoot);
16
- if (previous.neo4jVersion !== next.neo4jVersion) throw new Error('Automatic update requires the same Neo4j version; database upgrades require a separate migration.');
23
+ const upgrade = neo4jPatchUpgrade(previous.neo4jVersion, next.neo4jVersion, { backup: current.previousInstallation?.graphBackup });
17
24
  const path = join(current.dataDir, 'native-runtime', 'manifest.json');
18
25
  const bytes = existsSync(path) ? readFileSync(path) : null;
19
26
  if (bytes) requireOwnedDescriptor(bytes, previous, current.applicationVersion);
20
- return { path, bytes, next, downgrade };
27
+ else if (upgrade) throw new Error(`Upgrading Neo4j ${previous.neo4jVersion} → ${next.neo4jVersion} backs up the graph first, which needs the installed runtime record. Start Fuli ${current.applicationVersion} once, then update again.`);
28
+ const neo4jUpgrade = upgrade ? { from: previous.neo4jVersion, to: next.neo4jVersion,
29
+ backupDir: neo4jUpgradeBackupPath(graphBackupDirectory(current.dataDir), next.neo4jVersion, now()) } : null;
30
+ return { path, bytes, next, downgrade, neo4jUpgrade };
31
+ }
32
+
33
+ // Runs inside the switch, after the installed version stopped and before the
34
+ // record changes. The runtime descriptor still selects the installed Neo4j, so
35
+ // `fuli graph export`'s mechanism dumps the store with the version that wrote it.
36
+ // It runs in this process: the candidate's CLI cannot resolve its paths until
37
+ // the record names it. The switch decides what starts afterwards, never the export.
38
+ export async function backupWindowsGraph(snapshot, current, {
39
+ exportGraph = exportGraphData, createAdapter = createGraphBackupAdapter
40
+ } = {}) {
41
+ if (!snapshot.neo4jUpgrade) return;
42
+ const paths = resolveSetupPaths({ dataDir: current.dataDir, packageRoot: current.packageRoot, platform: 'win32' });
43
+ const adapter = await createAdapter({ mode: 'native', paths });
44
+ await exportGraph({ outputDir: snapshot.neo4jUpgrade.backupDir, sourceMode: 'native', instances: adapter.instances,
45
+ adapter: { ...adapter, start: async () => {} } });
21
46
  }
22
47
 
23
48
  // Runs inside the switch, after the current version stopped and before the record changes.
@@ -1,7 +1,6 @@
1
1
  import { randomUUID } from 'node:crypto';
2
2
  import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
3
3
  import { dirname, isAbsolute, join } from 'node:path';
4
- import { readWindowsNativeBundle, resolveWindowsNativeBundle } from '../native-runtime/windows-assets.js';
5
4
  import { compareSemanticVersions } from '../semantic-version.js';
6
5
  import { canonicalWindowsInstallPath, installationSha256, readWindowsInstallation, windowsInstallPathsOverlap } from './windows-installation-context.js';
7
6
  import { createWindowsShortcut, readWindowsShortcut, trayInventory } from './windows-installation.js';
@@ -41,13 +40,13 @@ export function planWindowsUpdate({ source, installRoot, env = process.env, read
41
40
  throw new Error(comparison === 0 ? 'This version is already installed.'
42
41
  : 'The update package must be newer than the installed version. To replace it with a lower version on purpose (for example a local rc build with a public beta), back up the data folder and run Update-Fuli with --allow-downgrade.');
43
42
  }
44
- snapshotWindowsUpdateRuntime(installed.current, source);
45
- return { source, ...installed, inventorySha256: inventory.inventorySha256, applicationVersion, downgrade: comparison < 0 };
43
+ const { neo4jUpgrade } = snapshotWindowsUpdateRuntime(installed.current, source);
44
+ return { source, ...installed, inventorySha256: inventory.inventorySha256, applicationVersion, downgrade: comparison < 0, neo4jUpgrade };
46
45
  }
47
46
 
48
47
  export async function updateWindowsInstallation(options, {
49
48
  runCli = runInstalledCli, createShortcut = createWindowsShortcut, readShortcut = readWindowsShortcut,
50
- acquireLock = acquireWindowsUpdateLock, write = () => {}, stopping
49
+ acquireLock = acquireWindowsUpdateLock, write = () => {}, stopping, backupGraph
51
50
  } = {}) {
52
51
  const plan = planWindowsUpdate({ ...options, readShortcut });
53
52
  if ((options.expectedInstallationId && options.expectedInstallationId !== plan.current.installationId)
@@ -67,12 +66,11 @@ export async function updateWindowsInstallation(options, {
67
66
  let staged;
68
67
  try {
69
68
  staged = stageUpdate(plan, inventory, installationId, packageRoot, createShortcut, readShortcut);
70
- staged.runtime = snapshotWindowsUpdateRuntime(plan.current, packageRoot);
71
69
  } catch (error) {
72
70
  discard();
73
71
  throw error;
74
72
  }
75
- return await stopAndSwitchWindowsInstallation(plan, staged, packageRoot, { runCli, lock, write, discard, stopping });
73
+ return await stopAndSwitchWindowsInstallation(plan, staged, packageRoot, { runCli, lock, write, discard, stopping, backupGraph });
76
74
  } finally { await lock.release(); }
77
75
  }
78
76
 
@@ -84,14 +82,16 @@ function stageUpdate(plan, inventory, installationId, packageRoot, createShortcu
84
82
  writeFileSync(join(packageRoot, name), bytes, { flag: 'wx' });
85
83
  }
86
84
  writeFileSync(join(packageRoot, 'tray-files.sha256.json'), inventory.bytes, { flag: 'wx' });
87
- resolveWindowsNativeBundle(readWindowsNativeBundle(packageRoot));
85
+ const runtime = snapshotWindowsUpdateRuntime(plan.current, packageRoot);
88
86
  const receipt = { version: 1, kind: 'windows-user-installation', installationId,
89
87
  installRoot: plan.installRoot, packageRoot, dataDir: plan.current.dataDir, inventorySha256: plan.inventorySha256 };
90
88
  writeFileSync(join(packageRoot, 'installed-context.json'), JSON.stringify(receipt, null, 2) + '\n', { flag: 'wx' });
91
89
  const next = { ...receipt, status: 'installed', applicationVersion: plan.applicationVersion,
92
90
  shortcuts: plan.current.shortcuts, ...(plan.current.adoptedExistingData ? { adoptedExistingData: true } : {}),
93
91
  previousInstallation: { installationId: plan.current.installationId, packageRoot: plan.current.packageRoot,
94
- applicationVersion: plan.current.applicationVersion } };
92
+ applicationVersion: plan.current.applicationVersion,
93
+ // Named when a rollback to an older Neo4j is refused (neo4j-version-policy.js).
94
+ ...(runtime.neo4jUpgrade ? { graphBackup: runtime.neo4jUpgrade.backupDir } : {}) } };
95
95
  const shortcuts = stageWindowsShortcuts(plan.shortcuts, packageRoot, createShortcut, readShortcut);
96
- return { next, record: Buffer.from(JSON.stringify(next, null, 2) + '\n'), shortcuts };
96
+ return { next, record: Buffer.from(JSON.stringify(next, null, 2) + '\n'), shortcuts, runtime };
97
97
  }
@@ -160,6 +160,7 @@ export function openFederatedGraphApplication({
160
160
  readUrl: () => readRuntimeSettings(paths.runtimeSettingsPath).notifications.needsPersonUrl });
161
161
  app.explainSettings = () => describeSettings({ settings: readRuntimeSettings(paths.runtimeSettingsPath),
162
162
  capturePolicy: app.getCapturePolicy(), consoleUrl: app.consoleUrl });
163
+ app.agentNamingStyle = () => readRuntimeSettings(paths.runtimeSettingsPath).agentNamingStyle;
163
164
  }
164
165
  return app;
165
166
  }
@@ -560,6 +560,7 @@ export function projectAgentTaskEventRecord(value = {}) {
560
560
  fallbackReason: value.executor_fallback_reason ?? value.fallback_reason ?? null,
561
561
  fallbackUsed: value.fallback_used ?? false,
562
562
  blockerClearedBy: value.blocker_cleared_by ?? null,
563
+ blockerClearNote: value.blocker_clear_note ?? null,
563
564
  createdAt: value.created_at
564
565
  };
565
566
  copyOptional(
@@ -8,6 +8,7 @@ import { handleDataFormatApiRequest } from './data-format-api-router.js';
8
8
  import { handleKnowledgeHardDeleteRequest } from './knowledge-hard-delete-api-router.js';
9
9
  import { handleKnowledgeScopeRequest } from './knowledge-scope-api-router.js';
10
10
  import { handleProjectHierarchyRequest } from './project-hierarchy-api-router.js';
11
+ import { handleTaskBlockerRequest } from './task-blocker-api-router.js';
11
12
  import { handleKnowledgeTagsRequest } from './knowledge-tags-api-router.js';
12
13
  import { handleStandingAssignmentRequest } from './standing-assignment-api-router.js';
13
14
  import { handleClientLinksRequest } from './client-links-api-router.js';
@@ -37,6 +38,7 @@ export async function handleApiRequest({
37
38
  knowledgeHardDelete = null,
38
39
  knowledgeScope = null,
39
40
  projectHierarchy = null,
41
+ taskBlockers = null,
40
42
  knowledgeOwnerReads = null,
41
43
  knowledgeTags = null,
42
44
  modelRoleSettings = null,
@@ -211,6 +213,7 @@ export async function handleApiRequest({
211
213
  await handleKnowledgeHardDeleteRequest({ request, response, url, app, hardDelete: knowledgeHardDelete }) ||
212
214
  await handleKnowledgeScopeRequest({ request, response, url, app, scopeConsole: knowledgeScope }) ||
213
215
  await handleProjectHierarchyRequest({ request, response, url, app, hierarchyConsole: projectHierarchy }) ||
216
+ await handleTaskBlockerRequest({ request, response, url, app, blockerConsole: taskBlockers }) ||
214
217
  await handleKnowledgeTagsRequest({ request, response, url, app, tagsConsole: knowledgeTags }) ||
215
218
  await handleJudgmentApiRequest({ request, response, url, app, undoConsole: judgmentUndo, ownerReads: knowledgeOwnerReads }) ||
216
219
  await handleStandingAssignmentRequest({ request, response, url, app }) ||
@@ -0,0 +1,35 @@
1
+ import { readJson, sendJson } from './response.js';
2
+ import { refuseRemoteDecision } from './request-policy.js';
3
+ import { validationError } from '../app/application-error.js';
4
+ import { requiredString } from '../validation/values.js';
5
+
6
+ const CLEAR_PATH = /^\/api\/project-agent-tasks\/([^/]+)\/blocker\/clear$/;
7
+ const MAX_ID = 128;
8
+ const MAX_NOTE = 500;
9
+
10
+ // The person marks a blocked task as no longer blocked (「标记为已解除」), with
11
+ // an optional short note. Accepted only on this computer and sent on the
12
+ // human-review channel (src/task-blockers), so an Agent can never post it,
13
+ // not even straight to the Provider with its own token. No Agent tool
14
+ // reaches this route.
15
+ export async function handleTaskBlockerRequest({ request, response, url, app, blockerConsole }) {
16
+ const match = url.pathname.match(CLEAR_PATH);
17
+ if (!match || request.method !== 'POST') return false;
18
+ response.setHeader('Cache-Control', 'no-store');
19
+ if (refuseRemoteDecision(request, response, 'Blocked tasks are marked unblocked only on this computer')) return true;
20
+ if (!blockerConsole) {
21
+ sendJson(response, 503, { error: 'Marking a task unblocked needs a local FULI installation' });
22
+ return true;
23
+ }
24
+ const body = await readJson(request);
25
+ if (body?.personalSpaceId !== app.config.personal.spaceId) {
26
+ throw validationError('Tasks are marked unblocked in the active personal space');
27
+ }
28
+ const taskId = requiredString(decodeURIComponent(match[1]), 'taskId', MAX_ID);
29
+ const personalProjectId = requiredString(body.personalProjectId, 'personalProjectId', MAX_ID);
30
+ const blank = body.note == null || (typeof body.note === 'string' && !body.note.trim());
31
+ const note = blank ? null : requiredString(body.note, 'note', MAX_NOTE);
32
+ sendJson(response, 200, await blockerConsole.markUnblocked(taskId,
33
+ { personalSpaceId: body.personalSpaceId, personalProjectId, note }));
34
+ return true;
35
+ }
@@ -0,0 +1,34 @@
1
+ import { mkdirSync, openSync, renameSync, rmSync, statSync } from 'node:fs';
2
+ import { dirname } from 'node:path';
3
+
4
+ // A detached child (Neo4j, the Graph Provider, the console) writes straight to
5
+ // this file and outlives the process that started it, so the size is bounded
6
+ // when each child starts: a log past the limit becomes `.1`, older copies move
7
+ // up, and the oldest is dropped.
8
+ const CHILD_LOG_MAX_BYTES = 50 * 1024 * 1024;
9
+ const CHILD_LOG_KEPT_COPIES = 3;
10
+ // Another process (an editor, a tail, a child that survived) holds the file
11
+ // without sharing deletion: keep appending rather than refuse to start.
12
+ const HELD_FILE_CODES = new Set(['EBUSY', 'EPERM', 'EACCES']);
13
+
14
+ /** Opens a child process's log for appending after rotating it when too large. Returns the descriptor. */
15
+ export function openChildProcessLog(logPath) {
16
+ mkdirSync(dirname(logPath), { recursive: true });
17
+ try {
18
+ rotateWhenFull(logPath);
19
+ } catch (error) {
20
+ if (!HELD_FILE_CODES.has(error.code)) throw error;
21
+ }
22
+ return openSync(logPath, 'a');
23
+ }
24
+
25
+ function rotateWhenFull(logPath) {
26
+ const size = statSync(logPath, { throwIfNoEntry: false })?.size ?? 0;
27
+ if (size <= CHILD_LOG_MAX_BYTES) return;
28
+ rmSync(`${logPath}.${CHILD_LOG_KEPT_COPIES}`, { force: true });
29
+ for (let copy = CHILD_LOG_KEPT_COPIES - 1; copy >= 1; copy -= 1) {
30
+ const older = `${logPath}.${copy}`;
31
+ if (statSync(older, { throwIfNoEntry: false })) renameSync(older, `${logPath}.${copy + 1}`);
32
+ }
33
+ renameSync(logPath, `${logPath}.1`);
34
+ }
@@ -12,6 +12,7 @@ const READ_TOOLS = new Set([
12
12
  'get_capture_policy',
13
13
  'read_session_records',
14
14
  'explain_settings',
15
+ 'get_agent_naming_style',
15
16
  'list_external_knowledge_connectors',
16
17
  'discover_external_knowledge_sources',
17
18
  'list_external_knowledge_bindings',
@@ -58,7 +58,8 @@ function overlaps(a, b) {
58
58
  return inside(a, b) || inside(b, a);
59
59
  }
60
60
 
61
- export async function managedNeo4jContainers(paths, version) {
61
+ // versions: the Neo4j versions this runtime may hold (the current one and a retained older patch).
62
+ export async function managedNeo4jContainers(paths, versions) {
62
63
  const root = join(paths.nativeRuntimeDir, 'neo4j-assets');
63
64
  let entries;
64
65
  try { entries = await readdir(root, { withFileTypes: true }); }
@@ -69,8 +70,8 @@ export async function managedNeo4jContainers(paths, version) {
69
70
  if (!entry.isDirectory() || !/^jvs-a-[a-f0-9-]+$/.test(entry.name)) throw new Error('Unknown Neo4j asset entry was preserved.');
70
71
  const container = join(root, entry.name);
71
72
  const receipt = JSON.parse(await readFile(join(container, 'fuli-asset-owner.json'), 'utf8'));
72
- if (receipt.kind !== 'fuli-neo4j-assets' || receipt.id !== entry.name || receipt.version !== version) throw new Error('Unowned Neo4j asset directory was preserved.');
73
- await assertManagedNeo4jHome(paths, join(container, `neo4j-community-${version}`), version);
73
+ if (receipt.kind !== 'fuli-neo4j-assets' || receipt.id !== entry.name || !versions.includes(receipt.version)) throw new Error('Unowned Neo4j asset directory was preserved.');
74
+ await assertManagedNeo4jHome(paths, join(container, `neo4j-community-${receipt.version}`), receipt.version);
74
75
  containers.push(container);
75
76
  }
76
77
  return containers;