fuli-context 0.23.0-beta.9 → 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 (725) hide show
  1. package/README.md +169 -979
  2. package/README.zh-CN.md +157 -830
  3. package/dist/web/assets/{AboutPage-Co0jsR1c.js → AboutPage-Dx07_Z8u.js} +1 -1
  4. package/dist/web/assets/AboutSectionHeading-BdhpM609.js +1 -0
  5. package/dist/web/assets/AboutSectionHeading-DjXpIV27.css +1 -0
  6. package/dist/web/assets/AgentAppsPage-5VW0uCTz.js +1 -0
  7. package/dist/web/assets/{AgentAppsPage-BuJWNNdL.css → AgentAppsPage-BCxrjrsE.css} +1 -1
  8. package/dist/web/assets/AgentAvatar-DbsG1_BY.css +1 -0
  9. package/dist/web/assets/AgentAvatar-DlAQP7gm.js +1 -0
  10. package/dist/web/assets/{AgentHand-CTKH7yFY.js → AgentHand-FPFg9-Y1.js} +1 -1
  11. package/dist/web/assets/AgentManagement-CLFw9oV9.css +1 -0
  12. package/dist/web/assets/AgentManagement-UTe4I3WA.js +7 -0
  13. package/dist/web/assets/AgentMentionCopy-B9eIIr3L.css +1 -0
  14. package/dist/web/assets/AgentMentionCopy-C5ExlutT.js +1 -0
  15. package/dist/web/assets/{AgentName-DNxVHPb0.js → AgentName-C8mYbtKs.js} +1 -1
  16. package/dist/web/assets/AgentProfilePage-BLeyT3By.js +5 -0
  17. package/dist/web/assets/{AgentProfilePage-D5QUzw5N.css → AgentProfilePage-DumsVHP1.css} +1 -1
  18. package/dist/web/assets/AgentServicesPage-B2mDUgYZ.css +1 -0
  19. package/dist/web/assets/AgentServicesPage-BXi152Xc.js +1 -0
  20. package/dist/web/assets/{AppViewerPage-BMnN0lgj.js → AppViewerPage-BR8ttEGa.js} +1 -1
  21. package/dist/web/assets/{BackToTop-BfdZE6xK.js → BackToTop-5_AQRMZl.js} +1 -1
  22. package/dist/web/assets/{BoardCardFieldsMenu-xjUzesvU.js → BoardCardFieldsMenu-Bb_Z9a4Q.js} +1 -1
  23. package/dist/web/assets/{BoardMoveMenu-CCvochC4.js → BoardMoveMenu-B-f8O6cC.js} +1 -1
  24. package/dist/web/assets/{Breadcrumb-ys780J7e.js → Breadcrumb-DtM5lZy5.js} +1 -1
  25. package/dist/web/assets/{CaptureChangePage-BY7KKPuU.js → CaptureChangePage-BzwcfacI.js} +1 -1
  26. package/dist/web/assets/ConnectionsPage-C_vgqwF2.js +1 -0
  27. package/dist/web/assets/ConnectionsPage-DS2PEG6K.css +1 -0
  28. package/dist/web/assets/{CopyFixPrompt-ERDPz6w7.js → CopyFixPrompt-CErC3Paj.js} +1 -1
  29. package/dist/web/assets/DataFormatPage-Ccy_e9rf.css +1 -0
  30. package/dist/web/assets/DataFormatPage-DwL4Ofc9.js +2 -0
  31. package/dist/web/assets/DebugTurnPage-UpK_3ZWY.js +1 -0
  32. package/dist/web/assets/DebugTurnsPage-C0aZg5-3.js +1 -0
  33. package/dist/web/assets/{DialogTitle-C86eI8Q_.js → DialogTitle-BQXOe8EK.js} +1 -1
  34. package/dist/web/assets/{EmployeeRedirectPage-B5Sh-mOu.js → EmployeeRedirectPage-BjWpXDSM.js} +1 -1
  35. package/dist/web/assets/EmployeeScopeDialog-Bt3ZlDyZ.js +1 -0
  36. package/dist/web/assets/EmployeeScopeDialog-U_-eNH0Z.css +1 -0
  37. package/dist/web/assets/{EmployeeWorkbench-BhReI8l6.css → EmployeeWorkbench-Bp9pUkfS.css} +1 -1
  38. package/dist/web/assets/EmployeeWorkbench-GtJIUD5G.js +4 -0
  39. package/dist/web/assets/FieldRoot-DRf4wM5x.js +1 -0
  40. package/dist/web/assets/FlaGrowth-DgVLB8hp.css +1 -0
  41. package/dist/web/assets/FlaGrowth-OQtTLTng.js +1 -0
  42. package/dist/web/assets/FlaOccupationKit-BvrKsosv.css +1 -0
  43. package/dist/web/assets/FlaOccupationKit-C-x4VrKk.js +1 -0
  44. package/dist/web/assets/{FlaTaskSheets-IQ1HsEu5.js → FlaTaskSheets-CoaF5CbQ.js} +1 -1
  45. package/dist/web/assets/FlasPage-CgIVOGFM.js +1 -0
  46. package/dist/web/assets/FlasPage-H99IZ9M6.css +1 -0
  47. package/dist/web/assets/{GrowthLoading-BMf6Z2MU.js → GrowthLoading-VuVo2vLf.js} +1 -1
  48. package/dist/web/assets/HowtoPage-CZ3mOdLc.js +1 -0
  49. package/dist/web/assets/{HowtoPage-BRV2W1Go.css → HowtoPage-CrvMmT6K.css} +1 -1
  50. package/dist/web/assets/InboxPage-1ue8vA7H.css +1 -0
  51. package/dist/web/assets/InboxPage-zNUnnYeJ.js +6 -0
  52. package/dist/web/assets/{KnowledgeDeleteButton-Bo7gXmnS.js → KnowledgeDeleteButton-BlUnSG3b.js} +1 -1
  53. package/dist/web/assets/{KnowledgeHardDeleteSection-amJaLmkS.js → KnowledgeHardDeleteSection-CznXBtHY.js} +1 -1
  54. package/dist/web/assets/KnowledgeItemEditPage-DGRNkAYd.js +1 -0
  55. package/dist/web/assets/{KnowledgeItemSummaryCard-CjcKr6Xr.js → KnowledgeItemSummaryCard-Co5JKBHl.js} +1 -1
  56. package/dist/web/assets/KnowledgeOrganizerPage-BWvF1GEu.js +1 -0
  57. package/dist/web/assets/KnowledgeOrganizerPage-CJaFkfS7.css +1 -0
  58. package/dist/web/assets/KnowledgePage--Z4_kAhq.js +1 -0
  59. package/dist/web/assets/KnowledgePeek-BgzQA9SI.js +1 -0
  60. package/dist/web/assets/{KnowledgePeek-Bm5jRVA9.css → KnowledgePeek-CwZVuSkf.css} +1 -1
  61. package/dist/web/assets/{KnowledgeTurnReceiptPage-CbRSAOkW.js → KnowledgeTurnReceiptPage-Csyjimeg.js} +1 -1
  62. package/dist/web/assets/KnowledgeWorkspace-0yOpWtEB.js +4 -0
  63. package/dist/web/assets/{KnowledgeWorkspace-DCoVFyf0.css → KnowledgeWorkspace-BgWo6lBj.css} +1 -1
  64. package/dist/web/assets/{MeAvatar-Ca5kjZR7.js → MeAvatar-aY_q8cKs.js} +1 -1
  65. package/dist/web/assets/{MeLink-CMsMg8E_.js → MeLink-B0pNwVLa.js} +1 -1
  66. package/dist/web/assets/MenuSeparator-BR-uLovR.js +1 -0
  67. package/dist/web/assets/ModelSettingsPage-B9PS1Kay.css +1 -0
  68. package/dist/web/assets/ModelSettingsPage-BL6MsF7C.js +1 -0
  69. package/dist/web/assets/{NotFoundPage-j5qbgkxY.js → NotFoundPage-Cr1MaPuk.js} +1 -1
  70. package/dist/web/assets/NoticeRow-BXZWn4EZ.js +1 -0
  71. package/dist/web/assets/NoticeRow-ktVO_9Es.css +1 -0
  72. package/dist/web/assets/OccupationsPage-CkVqZ2pz.js +1 -0
  73. package/dist/web/assets/OccupationsPage-Dup7WzNh.css +1 -0
  74. package/dist/web/assets/OverviewPage-DFW3Ua0Z.js +1 -0
  75. package/dist/web/assets/OverviewPage-Dr4jrXW4.css +1 -0
  76. package/dist/web/assets/{PageColumns-C93sMwwH.js → PageColumns-DvehZlYm.js} +1 -1
  77. package/dist/web/assets/PageOutline-CFGtHmOK.js +1 -0
  78. package/dist/web/assets/PageOutline-DG5ZYtA8.css +1 -0
  79. package/dist/web/assets/{PersonalProfilePage-DdBfHnqq.css → PersonalProfilePage-DnjNX2xK.css} +1 -1
  80. package/dist/web/assets/PersonalProfilePage-TxsNr44t.js +1 -0
  81. package/dist/web/assets/PersonalProjectsPage-AhgP6CL8.js +1 -0
  82. package/dist/web/assets/{PinIcon-Dp4Ubaw6.js → PinIcon-BTQsnxRY.js} +1 -1
  83. package/dist/web/assets/PopperContent-DtMksk76.js +1 -0
  84. package/dist/web/assets/{Presence-D-jzaDBV.js → Presence-B0zMpCF4.js} +1 -1
  85. package/dist/web/assets/ProfileAuthorChip-BqT9Vv65.js +1 -0
  86. package/dist/web/assets/ProfileAuthorChip-CAWNGoW3.css +1 -0
  87. package/dist/web/assets/{ProjectAgentsPage-RpfiV2Fm.css → ProjectAgentsPage-CjeXFzHr.css} +1 -1
  88. package/dist/web/assets/ProjectAgentsPage-O-cMavcz.js +5 -0
  89. package/dist/web/assets/{ProjectJudgmentPolicy-DR8Rk_1K.js → ProjectJudgmentPolicy-CyHAu0nm.js} +2 -2
  90. package/dist/web/assets/{PublicProjectsPage-QwAtKnu1.js → PublicProjectsPage-Ck1QSR0R.js} +1 -1
  91. package/dist/web/assets/RecentNotices-vJobVOcm.js +1 -0
  92. package/dist/web/assets/{RoundtablesPage-DLZdviOP.js → RoundtablesPage-C3dYekQ5.js} +6 -6
  93. package/dist/web/assets/{RoundtablesPage-DK9A9J-y.css → RoundtablesPage-DL-IOngN.css} +1 -1
  94. package/dist/web/assets/RovingFocusGroup-CUqyjFSs.js +1 -0
  95. package/dist/web/assets/{RovingFocusItem-HhNodnJn.js → RovingFocusItem-CyyuWXjE.js} +1 -1
  96. package/dist/web/assets/{SessionMigrationPage-_W2BnsjS.js → SessionMigrationPage-DukDM0TP.js} +1 -1
  97. package/dist/web/assets/SessionRecordsPage-DZ5ZBiuS.js +1 -0
  98. package/dist/web/assets/SettingsPage-BVIU7iFS.js +1 -0
  99. package/dist/web/assets/SettingsPage-Cj3pEWcd.css +1 -0
  100. package/dist/web/assets/SharedJefaReportPage-DUY03VLS.js +1 -0
  101. package/dist/web/assets/TagVocabularyPage-BKLFJiSu.js +1 -0
  102. package/dist/web/assets/TaskBlockerClear-BBmPbomO.css +1 -0
  103. package/dist/web/assets/TaskBlockerClear-BxOiiuK8.js +1 -0
  104. package/dist/web/assets/TaskBlockerNotice-iUiD3BuZ.js +1 -0
  105. package/dist/web/assets/{TaskReason-BgF2K1hA.js → TaskReason-D5j7L8tl.js} +1 -1
  106. package/dist/web/assets/TeamCard-CDunbIrP.js +1 -0
  107. package/dist/web/assets/TeamCard-CihQsZZ1.css +1 -0
  108. package/dist/web/assets/{TeamCardsWidget-CZTQVqyh.js → TeamCardsWidget-CUW-fPn7.js} +1 -1
  109. package/dist/web/assets/TeamIsland-CmpDmIX2.js +9 -0
  110. package/dist/web/assets/{TeamIsland-BBQbpozz.css → TeamIsland-DvtcsAsb.css} +1 -1
  111. package/dist/web/assets/{Teleport-Dg_IoSZh.js → Teleport-Dzdr8umQ.js} +1 -1
  112. package/dist/web/assets/{TextField-Y8DAIUw6.js → TextField-BPhEpEv9.js} +1 -1
  113. package/dist/web/assets/TonborgDelegationSwitch-C1nkJqkJ.js +1 -0
  114. package/dist/web/assets/TonborgDelegationSwitch-DeqERWoo.css +1 -0
  115. package/dist/web/assets/{UiChip-vvwIQTGB.js → UiChip-BEQ067LV.js} +1 -1
  116. package/dist/web/assets/UiDialog-JjqzOA0z.js +1 -0
  117. package/dist/web/assets/{UiDisclosure-Bp0vA9km.js → UiDisclosure-L6GEJHSw.js} +1 -1
  118. package/dist/web/assets/UiIcon-vgD4v8q8.js +1 -0
  119. package/dist/web/assets/UiIconButton-BzyMc14P.js +1 -0
  120. package/dist/web/assets/{UiSegmented-DX8WXXVn.js → UiSegmented-CIIm3KoV.js} +1 -1
  121. package/dist/web/assets/{UiWeight-Ci6wZg1W.js → UiWeight-D-2iZ_Kc.js} +1 -1
  122. package/dist/web/assets/VirtualDirectoryList-BJecsQct.css +1 -0
  123. package/dist/web/assets/VirtualDirectoryList-BV8KsA-Z.js +1 -0
  124. package/dist/web/assets/{VisuallyHidden-BLRDANy_.js → VisuallyHidden-BxKxuXRF.js} +1 -1
  125. package/dist/web/assets/VisuallyHiddenInput-DD4vhlqT.js +1 -0
  126. package/dist/web/assets/WidgetSlot-Dw5nWlb7.js +2 -0
  127. package/dist/web/assets/WorkbenchListHead-B0TjHsTO.js +1 -0
  128. package/dist/web/assets/WorkbenchListPage-BX6Z9gkB.css +1 -0
  129. package/dist/web/assets/WorkbenchListPage-D0xX-YNl.js +1 -0
  130. package/dist/web/assets/_plugin-vue_export-helper-B4pFJCwG.js +9 -0
  131. package/dist/web/assets/agent-apps-B1Je-mpY.js +1 -0
  132. package/dist/web/assets/agent-occupation-CjfQqSzd.js +1 -0
  133. package/dist/web/assets/{agent-pins-CoyKIkO2.js → agent-pins-DxHlJ96z.js} +1 -1
  134. package/dist/web/assets/agent-profile-BNPLhDog.css +1 -0
  135. package/dist/web/assets/{agent-roster-records-PfAgndHp.js → agent-roster-records-Bi5HWDif.js} +1 -1
  136. package/dist/web/assets/agent-work-summary-o_9-QWBL.js +1 -0
  137. package/dist/web/assets/{agent-workflows-CRdfc5xN.js → agent-workflows-DgdbJqpg.js} +1 -1
  138. package/dist/web/assets/{attach-closest-edge-BIyU46Kh.js → attach-closest-edge-DUc_VUVO.js} +1 -1
  139. package/dist/web/assets/{attention-store-BrThOc88.js → attention-store-Bod20yM3.js} +1 -1
  140. package/dist/web/assets/{badge-mwWygmG4.js → badge-tMy2Qr94.js} +1 -1
  141. package/dist/web/assets/{button-byjQ5eLH.js → button-DnKFsImW.js} +1 -1
  142. package/dist/web/assets/{card-Bo5Wyknz.js → card-Ccu7HCNb.js} +1 -1
  143. package/dist/web/assets/{catalog-CgoPKxd_.js → catalog-CJUV8OJ6.js} +1 -1
  144. package/dist/web/assets/checkbox-D1R6kTUB.js +1 -0
  145. package/dist/web/assets/{client-DmgW-kvA.js → client-D-G2i5VU.js} +2 -2
  146. package/dist/web/assets/client-links-store-UgmraFBZ.js +1 -0
  147. package/dist/web/assets/combobox-C7QLYGzs.js +1 -0
  148. package/dist/web/assets/console-DgRc8Itw.js +1 -0
  149. package/dist/web/assets/{conversation-launcher-settings-DVd61o9s.js → conversation-launcher-settings-CZAfuu8B.js} +1 -1
  150. package/dist/web/assets/copy-mention-C0EJhDPy.js +1 -0
  151. package/dist/web/assets/{dialog-CHAmruFj.js → dialog-Bbq93W68.js} +1 -1
  152. package/dist/web/assets/{dist-Bz5tCO-_.js → dist-Dd8yFhv6.js} +1 -1
  153. package/dist/web/assets/{dist-B9snV3GY.js → dist-PpsW5ZE3.js} +1 -1
  154. package/dist/web/assets/dropdown-menu-1fGUL0V3.js +1 -0
  155. package/dist/web/assets/{field-ZZb3Sy9Y.js → field-DjVv_wIS.js} +1 -1
  156. package/dist/web/assets/{format-bytes-DiEwa-ch.js → format-bytes-BKq_E0Hs.js} +1 -1
  157. package/dist/web/assets/hover-card-BO-929hq.js +1 -0
  158. package/dist/web/assets/{identity-4i_OR9WP.js → identity-DIG-uOiU.js} +1 -1
  159. package/dist/web/assets/index-C7IVLf_v.js +24 -0
  160. package/dist/web/assets/index-DF0TcfPY.css +1 -0
  161. package/dist/web/assets/{input-BP9Wn4Yk.js → input-DmwRmYO2.js} +1 -1
  162. package/dist/web/assets/is-equal-8VOV02sH.js +1 -0
  163. package/dist/web/assets/{label-xRSp2rqO.js → label-BvwPUTS4.js} +1 -1
  164. package/dist/web/assets/label-table-CDzYRZpc.js +1 -0
  165. package/dist/web/assets/{model-DRrCt6Xz.js → model-0TZRbkN2.js} +1 -1
  166. package/dist/web/assets/model-BF_ZMPLi.js +1 -0
  167. package/dist/web/assets/model-BjUERpoQ.js +3 -0
  168. package/dist/web/assets/model-CaR7VPg7.js +1 -0
  169. package/dist/web/assets/{model-6a2cm5q3.js → model-Dfe81jZT.js} +1 -1
  170. package/dist/web/assets/{model-DiJvQFH-.js → model-DpkZUZUL.js} +1 -1
  171. package/dist/web/assets/{model-CidDnNzT.js → model-Tmn6HvL-.js} +1 -1
  172. package/dist/web/assets/{model-P1cRTtx9.js → model-y7OUvtKz.js} +1 -1
  173. package/dist/web/assets/motion-C1fZrqmI.js +1 -0
  174. package/dist/web/assets/{motion-eJ8Y9ulR.js → motion-mAmbRj_M.js} +1 -1
  175. package/dist/web/assets/{motion-preference-CC0XwuGQ.js → motion-preference-Dz9S1bZa.js} +1 -1
  176. package/dist/web/assets/npm-copies-BLRc0FXW.js +1 -0
  177. package/dist/web/assets/{client-connection-model-DVwA-GIu.css → npm-copies-GRyMAduA.css} +1 -1
  178. package/dist/web/assets/occupation-catalog-_SnxxRbK.js +1 -0
  179. package/dist/web/assets/occupation-kits-DFC6Auuc.js +1 -0
  180. package/dist/web/assets/{option-CdihAKf9.js → option-DC8frdbr.js} +1 -1
  181. package/dist/web/assets/{orchestration-filters-DmF4Qs8E.js → orchestration-filters-UeiAHJqn.js} +1 -1
  182. package/dist/web/assets/overview-data-Cq1gefY5.js +1 -0
  183. package/dist/web/assets/page-refresh-DdRJaxMv.js +1 -0
  184. package/dist/web/assets/{page-title-CPUoKkyh.js → page-title-Cm9u_qw1.js} +1 -1
  185. package/dist/web/assets/person-profile-BH2AzOfw.js +1 -0
  186. package/dist/web/assets/popover-DW__YCSE.js +1 -0
  187. package/dist/web/assets/popup-host-ctKYu9Ze.js +1 -0
  188. package/dist/web/assets/profile-model-DtISOJ-X.js +1 -0
  189. package/dist/web/assets/{project-board-layout-BPk55Azx.js → project-board-layout-CTM8kAgq.js} +1 -1
  190. package/dist/web/assets/{project-capture-zRbPkI54.js → project-capture-B3pNhpFF.js} +1 -1
  191. package/dist/web/assets/{project-origin-BNl8Mqof.js → project-origin-BO8Ngccf.js} +1 -1
  192. package/dist/web/assets/quick-edit-api-B169r5Qb.js +1 -0
  193. package/dist/web/assets/radio-group-DqA46cXQ.js +1 -0
  194. package/dist/web/assets/review-api-CJaNgPMA.js +1 -0
  195. package/dist/web/assets/review-list-BbV-Mle7.js +1 -0
  196. package/dist/web/assets/review-store-DSQpb5P8.js +1 -0
  197. package/dist/web/assets/{role-names-BDswxugG.js → role-names-By0xdfTn.js} +1 -1
  198. package/dist/web/assets/roundtable-live-u9qUU6aA.js +1 -0
  199. package/dist/web/assets/{runtime-dom.esm-bundler-CjD1s0uc.js → runtime-dom.esm-bundler-DhFy4Djs.js} +1 -1
  200. package/dist/web/assets/save-file-oGyIokMI.js +1 -0
  201. package/dist/web/assets/select-TqPBladU.js +1 -0
  202. package/dist/web/assets/{session-launch-offers-2SxrTwBr.js → session-launch-offers-CtQeY4Qk.js} +1 -1
  203. package/dist/web/assets/{settings-restart-fHB-lEm8.js → settings-autosave-C7vW3_SP.js} +1 -1
  204. package/dist/web/assets/settings-restart-p12HUUve.js +1 -0
  205. package/dist/web/assets/shared-report-DQBSigHB.js +3 -0
  206. package/dist/web/assets/{source-adapters-TLaUKVEM.js → source-adapters-DPJzumzC.js} +1 -1
  207. package/dist/web/assets/{switch-Cq1rT1Ti.js → switch-D7w_0h3m.js} +1 -1
  208. package/dist/web/assets/tabs-DR8k0PN9.js +1 -0
  209. package/dist/web/assets/{task-card-fields-BkwTMtq6.js → task-card-fields-X1ZYCm_j.js} +1 -1
  210. package/dist/web/assets/{task-labels-CVomryt6.js → task-labels-LuXoQhF9.js} +1 -1
  211. package/dist/web/assets/{task-reason-BenU3Ly4.js → task-reason-ChpbGtyx.js} +1 -1
  212. package/dist/web/assets/{team-sheets-BIFVatFG.js → team-sheets-DYCQqa8I.js} +1 -1
  213. package/dist/web/assets/{textarea-CEokSlpT.js → textarea-D53VYanK.js} +1 -1
  214. package/dist/web/assets/ui-D4nAhcmu.css +1 -0
  215. package/dist/web/assets/ui-DmNbL8MW.js +1 -0
  216. package/dist/web/assets/{useAgentRecords-B0ODDGeO.js → useAgentRecords-Hy9nqMs7.js} +1 -1
  217. package/dist/web/assets/useAgentWorkSummary-mloD4p12.js +1 -0
  218. package/dist/web/assets/{useApi-CROJJdhE-CbQwoO_u.js → useApi-CROJJdhE-DnUGUb8O.js} +1 -1
  219. package/dist/web/assets/{useClipboardCopy-Dd9bf8dt.js → useClipboardCopy-BTuQMeWI.js} +1 -1
  220. package/dist/web/assets/{useFocusReturn-DFHFciMS.js → useFocusReturn-4hUmSzj9.js} +1 -1
  221. package/dist/web/assets/{useForwardExpose-D3bCxDJx.js → useForwardExpose-BDmW7q7u.js} +1 -1
  222. package/dist/web/assets/{useForwardPropsEmits-CshHUE63.js → useForwardPropsEmits-BzT2luD4.js} +1 -1
  223. package/dist/web/assets/useForwardScopeId-DZCnSswO.js +1 -0
  224. package/dist/web/assets/useKnowledgeConfirm-L8wnJCuX.js +1 -0
  225. package/dist/web/assets/useKnowledgeItemPeek-C_huXt6E.js +1 -0
  226. package/dist/web/assets/{useMinimumLoadingDisplay-Br2MBA-0.js → useMinimumLoadingDisplay-Dkl8NQru.js} +1 -1
  227. package/dist/web/assets/usePageTools-CbDOdIrg.js +1 -0
  228. package/dist/web/assets/usePrimitiveElement-tPQM7XJs.js +1 -0
  229. package/dist/web/assets/{useProjectAgentRoster-BLHF34Hj.js → useProjectAgentRoster-BBmRvcgr.js} +1 -1
  230. package/dist/web/assets/{useRoutePeek-KvY9hOQI.js → useRoutePeek-CRbCDqsm.js} +1 -1
  231. package/dist/web/assets/useTeamPeople-D_5cxxf1.js +1 -0
  232. package/dist/web/assets/{useTeamWork-wKGBRcNv.js → useTeamWork-CXEQwF4n.js} +1 -1
  233. package/dist/web/assets/{useTypeahead-C50w2tTI.js → useTypeahead-CVYuxPOD.js} +1 -1
  234. package/dist/web/assets/{utils-CArDYAhe.js → utils-BnrWDlfm.js} +1 -1
  235. package/dist/web/assets/utils-BsGjKHV8.js +1 -0
  236. package/dist/web/assets/verification-DbCo_dnY.js +1 -0
  237. package/dist/web/assets/version-1lwoVj6f.js +1 -0
  238. package/dist/web/assets/{vue-router-BzQKabzW.js → vue-router-D4_ms6om.js} +1 -1
  239. package/dist/web/assets/website-YgovUEcN.js +1 -0
  240. package/dist/web/assets/workbench-card-Dt0820yW.css +1 -0
  241. package/dist/web/index.html +90 -73
  242. package/docs/agent-conversations-and-collaboration.md +55 -58
  243. package/docs/agent-interface-architecture.md +7 -2
  244. package/docs/agent-roundtable.md +7 -7
  245. package/docs/client-connections.md +88 -10
  246. package/docs/client-links.md +16 -1
  247. package/docs/employee-agents.md +2 -2
  248. package/docs/judgment-and-autonomy.md +4 -2
  249. package/docs/public-personal-architecture.md +1 -1
  250. package/graph-provider/fuli_graph/app.py +6 -0
  251. package/graph-provider/fuli_graph/graph_field_contract.py +16 -5
  252. package/graph-provider/fuli_graph/graph_format_migrations.py +16 -0
  253. package/graph-provider/fuli_graph/graph_models.py +11 -62
  254. package/graph-provider/fuli_graph/graph_query.py +46 -105
  255. package/graph-provider/fuli_graph/knowledge_batch_confirmation.py +7 -5
  256. package/graph-provider/fuli_graph/knowledge_duplicate_models.py +24 -0
  257. package/graph-provider/fuli_graph/knowledge_duplicate_rules.py +157 -0
  258. package/graph-provider/fuli_graph/knowledge_duplicates.py +357 -0
  259. package/graph-provider/fuli_graph/knowledge_index_scan.py +120 -0
  260. package/graph-provider/fuli_graph/knowledge_item_routes.py +3 -1
  261. package/graph-provider/fuli_graph/knowledge_item_view.py +45 -2
  262. package/graph-provider/fuli_graph/knowledge_item_view_models.py +21 -0
  263. package/graph-provider/fuli_graph/knowledge_management.py +6 -1
  264. package/graph-provider/fuli_graph/knowledge_outdated.py +15 -5
  265. package/graph-provider/fuli_graph/knowledge_retrieval_models.py +95 -0
  266. package/graph-provider/fuli_graph/knowledge_retrieval_terms.py +116 -0
  267. package/graph-provider/fuli_graph/knowledge_review.py +65 -2
  268. package/graph-provider/fuli_graph/knowledge_review_models.py +5 -0
  269. package/graph-provider/fuli_graph/knowledge_search.py +191 -62
  270. package/graph-provider/fuli_graph/knowledge_semantic.py +87 -0
  271. package/graph-provider/fuli_graph/knowledge_semantic_index.py +98 -0
  272. package/graph-provider/fuli_graph/knowledge_semantic_models.py +72 -0
  273. package/graph-provider/fuli_graph/knowledge_semantic_query.py +19 -0
  274. package/graph-provider/fuli_graph/knowledge_versions.py +12 -1
  275. package/graph-provider/fuli_graph/models.py +13 -2
  276. package/graph-provider/fuli_graph/preference_versions.py +28 -7
  277. package/graph-provider/fuli_graph/project_agent_routes.py +60 -2
  278. package/graph-provider/fuli_graph/project_agent_task_models.py +63 -5
  279. package/graph-provider/fuli_graph/store.py +2 -0
  280. package/graph-provider/fuli_graph/store_project_agent_task_activity.py +12 -3
  281. package/graph-provider/fuli_graph/store_project_agent_task_blockers.py +110 -23
  282. package/graph-provider/fuli_graph/store_project_agent_task_pages.py +186 -0
  283. package/graph-provider/fuli_graph/store_project_agent_task_reads.py +6 -4
  284. package/graph-provider/fuli_graph/store_project_agent_task_recruitment.py +0 -7
  285. package/graph-provider/fuli_graph/store_project_agent_tasks.py +4 -3
  286. package/graph-provider/fuli_graph/store_task_contexts.py +14 -4
  287. package/graph-provider/fuli_graph/task_blocker.py +38 -6
  288. package/graph-provider/fuli_graph/task_context_routes.py +1 -1
  289. package/graph-provider/fuli_graph/tonborg_confirmation.py +48 -0
  290. package/graph-provider/pyproject.toml +1 -1
  291. package/native/win32/fuli-win-helper.exe +0 -0
  292. package/npm-shrinkwrap.json +16 -50
  293. package/package.json +2 -2
  294. package/packages/roundtable/src/peer/node-store.js +2 -6
  295. package/packages/roundtable/src/roundtable/chat-service.js +2 -1
  296. package/packages/roundtable/src/roundtable/chat.js +11 -1
  297. package/packages/roundtable/src/roundtable/delivery-state.js +43 -0
  298. package/packages/roundtable/src/roundtable/fla-address.js +6 -0
  299. package/packages/roundtable/src/roundtable/group-discussion-store.js +2 -2
  300. package/packages/roundtable/src/roundtable/group-discussion.js +15 -15
  301. package/packages/roundtable/src/roundtable/person-conversation.js +2 -1
  302. package/packages/roundtable/src/roundtable/service.js +38 -9
  303. package/packages/roundtable/src/roundtable/store.js +8 -5
  304. package/packages/roundtable/src/storage/database-format.js +21 -16
  305. package/registry/client-links.json +66 -4
  306. package/registry/occupation-plugins.json +593 -0
  307. package/skills/capturing-session-knowledge/SKILL.md +24 -7
  308. package/skills/capturing-session-knowledge/references/capture.md +22 -6
  309. package/skills/capturing-session-knowledge/references/coordination.md +16 -6
  310. package/skills/capturing-session-knowledge/references/retrieval.md +25 -6
  311. package/skills/flreview/SKILL.md +1 -1
  312. package/skills/operating-fuli/SKILL.md +42 -11
  313. package/skills/operating-fuli/references/workflow-recipes.md +9 -5
  314. package/src/acceptance-checks/port.js +37 -0
  315. package/src/adaptive-runtime/settings.js +1 -1
  316. package/src/adaptive-runtime/state.js +3 -3
  317. package/src/agent-apps/host-tools/catalog.js +7 -0
  318. package/src/agent-apps/store.js +2 -10
  319. package/src/agent-delegation/person-words.js +15 -1
  320. package/src/agent-kits/cli-presence.js +78 -0
  321. package/src/agent-kits/client-detection.js +7 -0
  322. package/src/agent-kits/client-installer.js +20 -3
  323. package/src/agent-kits/installer-manifest.js +11 -6
  324. package/src/agent-kits/legacy-hook-cleanup.js +4 -3
  325. package/src/agent-kits/new-sessions.js +82 -0
  326. package/src/agent-kits/opencode-plugin-gate.js +3 -1
  327. package/src/agent-kits/pins.js +12 -12
  328. package/src/agent-kits/ports.js +5 -2
  329. package/src/agent-kits/session-launcher.js +11 -4
  330. package/src/agent-kits/vendor/agent-installer/README.md +1 -1
  331. package/src/agent-kits/vendor/agent-installer/index.d.ts +1 -1
  332. package/src/agent-kits/vendor/agent-session-launcher/README.md +1 -1
  333. package/src/agent-kits/vendor/agent-session-launcher/index.d.ts +30 -1
  334. package/src/agent-kits/vendor/agent-session-launcher/index.mjs +8 -0
  335. package/src/agent-roundtable/tools.js +3 -3
  336. package/src/agent-services/store.js +2 -4
  337. package/src/agent-tools/agent-workflow-definitions.js +7 -3
  338. package/src/agent-tools/checkpoint-definitions.js +5 -4
  339. package/src/agent-tools/fla-lesson-definitions.js +24 -0
  340. package/src/agent-tools/graph-definitions.js +8 -0
  341. package/src/agent-tools/graph-handlers.js +10 -1
  342. package/src/agent-tools/interface-catalog.js +38 -7
  343. package/src/agent-tools/model-backend-definitions.js +1 -1
  344. package/src/agent-tools/occupation-kit-definitions.js +20 -0
  345. package/src/agent-tools/project-agent-definitions.js +19 -40
  346. package/src/agent-tools/project-agent-tool-definitions.js +5 -1
  347. package/src/agent-tools/reply-echo-definitions.js +18 -0
  348. package/src/agent-tools/tonborg-question-definitions.js +26 -0
  349. package/src/agent-workflows/agent-tools.js +69 -3
  350. package/src/agent-workflows/port.js +32 -4
  351. package/src/agent-workflows/store.js +16 -9
  352. package/src/agents/choice-answers.js +19 -0
  353. package/src/agents/claude-code/choice-answers.js +49 -0
  354. package/src/agents/claude-code/fla-menu-command.js +14 -0
  355. package/src/agents/claude-code/lifecycle-hook.js +16 -9
  356. package/src/agents/claude-code/transcript-format-probe.js +31 -0
  357. package/src/agents/claude-code/turn-records.js +38 -0
  358. package/src/agents/codex/fla-prompts.js +98 -0
  359. package/src/agents/codex/lifecycle-hook.js +9 -8
  360. package/src/agents/codex/transcript-format-probe.js +29 -0
  361. package/src/agents/cursor/lifecycle-hook.js +3 -2
  362. package/src/agents/identity-receipt.js +9 -7
  363. package/src/agents/lifecycle-failure.js +9 -0
  364. package/src/agents/lifecycle-message.js +4 -5
  365. package/src/agents/opencode/lifecycle-hook.js +12 -7
  366. package/src/agents/opencode/plugin.js +7 -2
  367. package/src/agents/token-usage-resolver.js +1 -1
  368. package/src/agents/transcript-format-registry.js +34 -0
  369. package/src/agents/transcript-format-scan.js +71 -0
  370. package/src/agents/turn-receipt.js +5 -4
  371. package/src/cli/command-registry.js +1 -1
  372. package/src/cli/local-runtime-command.js +5 -2
  373. package/src/cli/local-runtime-options.js +7 -3
  374. package/src/cli/models-command.js +15 -11
  375. package/src/cli/update-command.js +2 -2
  376. package/src/cli/update-installation.js +23 -6
  377. package/src/cli/workspace-connection-command.js +2 -2
  378. package/src/client-links/registry.js +6 -112
  379. package/src/conversations/entry-skeleton.js +113 -55
  380. package/src/conversations/human-interaction.js +1 -1
  381. package/src/conversations/person-words.js +29 -0
  382. package/src/conversations/preference-lifecycle.js +2 -1
  383. package/src/conversations/preference-session.js +17 -14
  384. package/src/conversations/reply-citations.js +21 -0
  385. package/src/conversations/stop-auto-close.js +42 -9
  386. package/src/conversations/task-context-view.js +113 -27
  387. package/src/conversations/turn-findings.js +105 -0
  388. package/src/data-format/format-notices.js +2 -1
  389. package/src/data-format/local-stores.js +22 -1
  390. package/src/debug-turns/model-capture.js +1 -1
  391. package/src/debug-turns/record.js +1 -1
  392. package/src/desktop/cli-path.js +253 -0
  393. package/src/desktop/desktop-app-package.js +31 -0
  394. package/src/desktop/{fuli-links.js → desktop-client-links.js} +20 -16
  395. package/src/desktop/desktop-controller.js +35 -3
  396. package/src/desktop/npm-adoption-store.js +7 -0
  397. package/src/desktop/npm-adoption.js +119 -0
  398. package/src/desktop/npm-copies.js +73 -0
  399. package/src/desktop/npm-copy-control.js +56 -0
  400. package/src/desktop/npm-copy-data.js +51 -0
  401. package/src/desktop/npm-copy-uninstall.js +67 -0
  402. package/src/desktop/windows-controller.js +13 -1
  403. package/src/desktop/windows-installation-switch.js +1 -1
  404. package/src/desktop/windows-node-launcher.js +11 -0
  405. package/src/desktop/windows-uninstall.js +3 -0
  406. package/src/dreaming/astro-calls.js +47 -0
  407. package/src/dreaming/projects.js +39 -0
  408. package/src/dreaming/run.js +312 -0
  409. package/src/dreaming/scheduler.js +58 -0
  410. package/src/employees/builtin/jefa/board-store.js +2 -10
  411. package/src/employees/builtin/jefa/tools.js +1 -1
  412. package/src/employees/management-policy.js +1 -1
  413. package/src/employees/manifest.js +1 -1
  414. package/src/employees/service.js +11 -1
  415. package/src/external-knowledge/document-mapping.js +1 -1
  416. package/src/external-knowledge/index.js +0 -4
  417. package/src/fla-growth/lessons.js +40 -0
  418. package/src/fla-growth/task-verification.js +25 -0
  419. package/src/fla-growth/tool-suggestions.js +107 -0
  420. package/src/fla-growth/verification.js +30 -0
  421. package/src/graphiti/agent-access-policy.js +1 -1
  422. package/src/graphiti/agent-conversations.js +2 -2
  423. package/src/graphiti/agent-growth.js +32 -4
  424. package/src/graphiti/capture-change-confirmation.js +4 -1
  425. package/src/graphiti/capture-notice.js +2 -1
  426. package/src/graphiti/capture-onboarding.js +1 -1
  427. package/src/graphiti/collaboration-preference-projection.js +1 -1
  428. package/src/graphiti/conversation-triage.js +1 -1
  429. package/src/graphiti/current-project-knowledge-search.js +24 -1
  430. package/src/graphiti/execution-mode.js +1 -1
  431. package/src/graphiti/federated-application.js +16 -8
  432. package/src/graphiti/federated-search.js +8 -1
  433. package/src/graphiti/fla-mention.js +105 -96
  434. package/src/graphiti/fla-menu-reader.js +25 -0
  435. package/src/graphiti/fla-menu.js +108 -0
  436. package/src/graphiti/fla-picker.js +21 -16
  437. package/src/graphiti/fuli-markup.js +60 -0
  438. package/src/graphiti/group-member-context.js +1 -1
  439. package/src/graphiti/human-review-channel.js +16 -2
  440. package/src/graphiti/knowledge-result-budget.js +2 -2
  441. package/src/graphiti/knowledge-review.js +2 -1
  442. package/src/graphiti/local-runtimes.js +11 -0
  443. package/src/graphiti/preference-task-scope.js +1 -1
  444. package/src/graphiti/project-agent-control-plane.js +6 -0
  445. package/src/graphiti/project-agent-mapping.js +23 -10
  446. package/src/graphiti/project-agent-mention.js +10 -28
  447. package/src/graphiti/project-agent-task-entry.js +1 -1
  448. package/src/graphiti/project-agent-task-sheets.js +1 -1
  449. package/src/graphiti/project-agent-workflows.js +20 -5
  450. package/src/graphiti/project-knowledge-presence.js +27 -0
  451. package/src/graphiti/project-path-context.js +2 -2
  452. package/src/graphiti/provider-client.js +60 -0
  453. package/src/graphiti/recall-policy.js +1 -1
  454. package/src/graphiti/reply-echo-agent-tool.js +36 -0
  455. package/src/graphiti/reply-echo-group.js +85 -0
  456. package/src/graphiti/reply-echo.js +87 -0
  457. package/src/graphiti/session-knowledge-migration.js +2 -1
  458. package/src/graphiti/session-prompt-sentences.js +52 -0
  459. package/src/graphiti/session-records.js +3 -2
  460. package/src/graphiti/source-marker.js +14 -0
  461. package/src/graphiti/task-blocker-progress.js +24 -1
  462. package/src/graphiti/task-context-entry.js +11 -0
  463. package/src/graphiti/task-entry-group-discussion.js +31 -31
  464. package/src/graphiti/task-entry-named-fla.js +40 -70
  465. package/src/graphiti/task-entry-preferences.js +16 -3
  466. package/src/graphiti/task-entry-project-scope.js +4 -4
  467. package/src/graphiti/task-entry-read-only.js +28 -0
  468. package/src/graphiti/task-entry-standing-owner.js +3 -3
  469. package/src/graphiti/task-experiences.js +21 -3
  470. package/src/graphiti/task-knowledge-checkpoint.js +4 -1
  471. package/src/graphiti/task-knowledge-recall.js +157 -28
  472. package/src/graphiti/task-prompt-statement.js +49 -0
  473. package/src/graphiti/task-remember.js +23 -9
  474. package/src/graphiti/task-stated-rules.js +75 -0
  475. package/src/graphiti/temporary-project-scope.js +1 -1
  476. package/src/graphiti/topic-proposals.js +6 -5
  477. package/src/graphiti/user-taste-skill.js +1 -1
  478. package/src/graphiti/workflow-candidate-mapping.js +1 -1
  479. package/src/http/agent-delegation-gate.js +9 -0
  480. package/src/http/api-router.js +27 -1
  481. package/src/http/cli-path-api-router.js +35 -0
  482. package/src/http/desktop-client-api-router.js +18 -0
  483. package/src/http/dreaming-api-router.js +35 -0
  484. package/src/http/graph-api-router.js +17 -0
  485. package/src/http/knowledge-item-api-router.js +7 -0
  486. package/src/http/notices-api-router.js +37 -0
  487. package/src/http/npm-copies-api-router.js +36 -0
  488. package/src/http/occupation-plugins-api-router.js +43 -0
  489. package/src/http/reply-echo-api-router.js +53 -0
  490. package/src/http/response.js +1 -1
  491. package/src/http/retrieval-terms-api-router.js +37 -0
  492. package/src/http/retrospectives-api-router.js +18 -0
  493. package/src/http/semantic-api-router.js +26 -0
  494. package/src/http/session-launch-api-router.js +34 -1
  495. package/src/http/static-handler.js +1 -1
  496. package/src/http/task-blocker-api-router.js +17 -5
  497. package/src/http/task-verification-api-router.js +16 -0
  498. package/src/http/whats-new-api-router.js +34 -0
  499. package/src/judgment/acceptance.js +10 -3
  500. package/src/judgment/agent-view.js +21 -4
  501. package/src/judgment/conversation.js +86 -2
  502. package/src/judgment/delegated-reviews.js +23 -0
  503. package/src/judgment/engine.js +49 -16
  504. package/src/judgment/explain-method.js +11 -0
  505. package/src/judgment/http.js +17 -2
  506. package/src/judgment/question-options.js +97 -0
  507. package/src/judgment/question-tools.js +235 -0
  508. package/src/judgment/review-delegation.js +89 -0
  509. package/src/judgment/review-prompt.js +44 -3
  510. package/src/judgment/review-verdicts.js +13 -4
  511. package/src/judgment/runtime.js +3 -1
  512. package/src/judgment/service.js +25 -5
  513. package/src/judgment/store.js +44 -8
  514. package/src/judgment/verdict-schema.js +6 -0
  515. package/src/judgment/visible-items.js +15 -4
  516. package/src/knowledge-duplicates/scheduler.js +28 -0
  517. package/src/knowledge-hard-delete/forget-references.js +5 -2
  518. package/src/knowledge-impressions/store.js +17 -5
  519. package/src/local-runtime/console-autostart-record.js +95 -0
  520. package/src/local-runtime/console-autostart.js +143 -0
  521. package/src/local-runtime/console-health.js +26 -0
  522. package/src/local-runtime/installed-console-launcher.js +73 -0
  523. package/src/local-runtime/lifecycle.js +88 -21
  524. package/src/local-runtime/processes.js +15 -2
  525. package/src/local-runtime/unresponsive-console.js +77 -0
  526. package/src/local-runtime/windows-process-handle.js +9 -3
  527. package/src/mcp/create-mcp-server.js +4 -0
  528. package/src/mcp/fla-menu-prompts.js +60 -0
  529. package/src/mcp/process-registry.js +45 -3
  530. package/src/mcp/runtime.js +13 -4
  531. package/src/mcp/session-id.js +3 -2
  532. package/src/mcp/stdio-relay.js +4 -1
  533. package/src/mcp/tool-annotations.js +5 -2
  534. package/src/mcp/tool-profiles.js +1 -1
  535. package/src/mcp/tool-result.js +3 -1
  536. package/src/model-backends/adapters/anthropic-messages.js +3 -3
  537. package/src/model-backends/adapters/exchange.js +2 -2
  538. package/src/model-backends/adapters/ollama-local-build.js +1 -1
  539. package/src/model-backends/adapters/openai-chat.js +3 -3
  540. package/src/model-backends/adapters/openai-embeddings.js +60 -0
  541. package/src/model-backends/adapters/registry.js +3 -1
  542. package/src/model-backends/adapters/typesafe-systemone.js +1 -1
  543. package/src/model-backends/budget.js +23 -8
  544. package/src/model-backends/config.js +50 -16
  545. package/src/model-backends/decision-contract.js +2 -1
  546. package/src/model-backends/endpoint-models.js +80 -0
  547. package/src/model-backends/http.js +22 -2
  548. package/src/model-backends/keys-http.js +5 -4
  549. package/src/model-backends/model-fetch.js +37 -0
  550. package/src/model-backends/models-http.js +54 -0
  551. package/src/model-backends/port.js +194 -69
  552. package/src/model-backends/prompt.js +15 -4
  553. package/src/model-backends/request.js +42 -3
  554. package/src/model-backends/role-settings.js +27 -2
  555. package/src/model-backends/role-trust.js +3 -15
  556. package/src/model-backends/role-work-store.js +2 -12
  557. package/src/model-backends/runtime.js +11 -2
  558. package/src/model-backends/secret-store.js +61 -12
  559. package/src/model-backends/suggestion-log.js +6 -15
  560. package/src/model-backends/usage-ledger.js +28 -18
  561. package/src/notices/recent-notices.js +175 -0
  562. package/src/notifications/needs-person.js +1 -1
  563. package/src/occupation-plugins/agent-tools.js +59 -0
  564. package/src/occupation-plugins/choice-store.js +65 -0
  565. package/src/occupation-plugins/manifest.js +165 -0
  566. package/src/occupation-plugins/port.js +104 -0
  567. package/src/occupation-plugins/recruitment.js +38 -0
  568. package/src/presence/windows-helper-pin.js +1 -1
  569. package/src/registry/updatable-manifest.js +127 -0
  570. package/src/retrieval-terms/fill.js +102 -0
  571. package/src/retrieval-terms/runner.js +50 -0
  572. package/src/retrieval-terms/terms-model.js +99 -0
  573. package/src/retrospectives/run.js +113 -0
  574. package/src/retrospectives/runs.js +18 -0
  575. package/src/retrospectives/scheduler.js +58 -0
  576. package/src/semantic/scheduler.js +50 -0
  577. package/src/semantic/semantic-index.js +94 -0
  578. package/src/server/application-lifecycle.js +1 -1
  579. package/src/server/signal-shutdown.js +31 -0
  580. package/src/server.js +41 -18
  581. package/src/setup/first-run-capture.js +6 -2
  582. package/src/setup/graph-runtime.js +46 -38
  583. package/src/setup/neo4j-memory-profile.js +1 -1
  584. package/src/setup/paths.js +2 -0
  585. package/src/standing-assignments/store.js +2 -4
  586. package/src/system/client-connection-status.js +8 -4
  587. package/src/system/doctor.js +80 -4
  588. package/src/system/graph-migration.js +1 -1
  589. package/src/system/mcp-process-scan.js +55 -0
  590. package/src/system/platform-path.js +21 -9
  591. package/src/system/runtime-settings.js +19 -7
  592. package/src/system/settings-guide.js +7 -0
  593. package/src/system/system-service.js +64 -7
  594. package/src/task-blockers/console-port.js +12 -6
  595. package/src/text/markdown-link.js +12 -0
  596. package/src/text/single-line.js +6 -0
  597. package/src/text/utf8-preview.js +7 -6
  598. package/src/whats-new/lines/0.25.0.json +17 -0
  599. package/src/whats-new/release-lines.js +66 -0
  600. package/src/whats-new/whats-new.js +70 -0
  601. package/src/work-surfaces/store.js +2 -4
  602. package/dist/web/assets/AboutSectionHeading-CiD3M3eG.css +0 -1
  603. package/dist/web/assets/AboutSectionHeading-w5P9g9WB.js +0 -1
  604. package/dist/web/assets/AgentAppsPage-DY_TV5EE.js +0 -1
  605. package/dist/web/assets/AgentManagement-CeF4mjtg.css +0 -1
  606. package/dist/web/assets/AgentManagement-VWpTW_38.js +0 -7
  607. package/dist/web/assets/AgentMentionCopy-CNKrzZvE.css +0 -1
  608. package/dist/web/assets/AgentMentionCopy-DI23ym95.js +0 -1
  609. package/dist/web/assets/AgentProfilePage-DrqWGjqt.js +0 -5
  610. package/dist/web/assets/AgentServicesPage-ARIWfmuh.css +0 -1
  611. package/dist/web/assets/AgentServicesPage-DEz1dnct.js +0 -1
  612. package/dist/web/assets/ConnectionsPage-Cj-T0BH2.js +0 -1
  613. package/dist/web/assets/ConnectionsPage-Cwt-knQQ.css +0 -1
  614. package/dist/web/assets/DataFormatPage-0Ne27K6I.css +0 -1
  615. package/dist/web/assets/DataFormatPage-D39VmkWL.js +0 -2
  616. package/dist/web/assets/DebugTurnPage-C6xOOTYf.js +0 -1
  617. package/dist/web/assets/DebugTurnsPage-uclemAXU.js +0 -1
  618. package/dist/web/assets/EmployeeScopeDialog-DbEgouOr.js +0 -1
  619. package/dist/web/assets/EmployeeScopeDialog-Do5PHQh7.css +0 -1
  620. package/dist/web/assets/EmployeeWorkbench-Cd0Yrv4Z.js +0 -4
  621. package/dist/web/assets/FieldRoot-BZby7Lhw.js +0 -1
  622. package/dist/web/assets/FlaGrowth-BS5MVg54.js +0 -1
  623. package/dist/web/assets/FlaGrowth-BzXY8pcx.css +0 -1
  624. package/dist/web/assets/FlasPage-DsAcdiFS.js +0 -1
  625. package/dist/web/assets/FlasPage-SLQDMv47.css +0 -1
  626. package/dist/web/assets/HowtoPage-CKJAtKbM.js +0 -1
  627. package/dist/web/assets/InboxPage-Bkx6nIhb.css +0 -1
  628. package/dist/web/assets/InboxPage-DPV8n8FW.js +0 -4
  629. package/dist/web/assets/KnowledgeItemEditPage-n0jtTdHB.js +0 -1
  630. package/dist/web/assets/KnowledgeOrganizerPage-CNm2jvJZ.css +0 -1
  631. package/dist/web/assets/KnowledgeOrganizerPage-CzXXBL9z.js +0 -1
  632. package/dist/web/assets/KnowledgePage-CZ9oDt3D.js +0 -1
  633. package/dist/web/assets/KnowledgePeek-J6gHDda8.js +0 -1
  634. package/dist/web/assets/KnowledgeWorkspace-6C9dPHLk.js +0 -4
  635. package/dist/web/assets/MenuSeparator-BlL75cLC.js +0 -1
  636. package/dist/web/assets/ModelSettingsPage-BwUnvtP6.js +0 -1
  637. package/dist/web/assets/ModelSettingsPage-ConWy_ec.css +0 -1
  638. package/dist/web/assets/OccupationsPage-DLIkdMDv.js +0 -1
  639. package/dist/web/assets/OccupationsPage-Di7B-bPl.css +0 -1
  640. package/dist/web/assets/OverviewPage-BeExbgPK.js +0 -1
  641. package/dist/web/assets/OverviewPage-xdF5g6bZ.css +0 -1
  642. package/dist/web/assets/PageOutline-BqVgnlos.css +0 -1
  643. package/dist/web/assets/PageOutline-Dtu7R8Wo.js +0 -1
  644. package/dist/web/assets/PersonalProfilePage-CIeXNXqv.js +0 -1
  645. package/dist/web/assets/PersonalProjectsPage-DM70jshg.js +0 -1
  646. package/dist/web/assets/PopperContent-D6WQ0NV4.js +0 -1
  647. package/dist/web/assets/ProfileAuthorChip-C_0hzDoP.css +0 -1
  648. package/dist/web/assets/ProfileAuthorChip-CpLzynWF.js +0 -1
  649. package/dist/web/assets/ProjectAgentsPage-v-Wtq-2-.js +0 -5
  650. package/dist/web/assets/RovingFocusGroup-CmwaBpdi.js +0 -1
  651. package/dist/web/assets/SessionRecordsPage-CedaErNM.js +0 -1
  652. package/dist/web/assets/SettingsPage-D85vqpZb.css +0 -1
  653. package/dist/web/assets/SettingsPage-aRxdnfBu.js +0 -1
  654. package/dist/web/assets/SharedJefaReportPage-BkmmPYH1.js +0 -1
  655. package/dist/web/assets/TagVocabularyPage-Bcd5fvzW.js +0 -1
  656. package/dist/web/assets/TaskBlockerClear-Bln3zxga.js +0 -1
  657. package/dist/web/assets/TaskBlockerClear-CjSNfpyP.css +0 -1
  658. package/dist/web/assets/TaskBlockerNotice-Db1uAtT2.js +0 -1
  659. package/dist/web/assets/TeamCard-B4J2jkm5.js +0 -1
  660. package/dist/web/assets/TeamCard-CsmWDw2Q.css +0 -1
  661. package/dist/web/assets/TeamIsland-DXIQQ3bx.js +0 -9
  662. package/dist/web/assets/UiDialog-Cbb3AvXb.js +0 -1
  663. package/dist/web/assets/UiIcon-o5x6Sf-c.js +0 -1
  664. package/dist/web/assets/UiIconButton-EZ8ktpFH.js +0 -1
  665. package/dist/web/assets/UiNotice-DYZn5s6m.js +0 -1
  666. package/dist/web/assets/VirtualDirectoryList-1vLi41SD.css +0 -1
  667. package/dist/web/assets/VirtualDirectoryList-XB8MT97E.js +0 -1
  668. package/dist/web/assets/VisuallyHiddenInput-D-GgOU3T.js +0 -1
  669. package/dist/web/assets/WidgetSlot-URHq8Let.js +0 -2
  670. package/dist/web/assets/_plugin-vue_export-helper-PxAQThRD.js +0 -9
  671. package/dist/web/assets/agent-apps-CQf2Eba8.js +0 -1
  672. package/dist/web/assets/agent-avatar-lPJyVS9O.js +0 -1
  673. package/dist/web/assets/agent-occupation-DM6nIHrD.js +0 -1
  674. package/dist/web/assets/agent-profile-Clb-gYu-.css +0 -1
  675. package/dist/web/assets/agent-work-summary-bzTwEUaA.js +0 -1
  676. package/dist/web/assets/checkbox-BB8_0W6A.js +0 -1
  677. package/dist/web/assets/client-connection-model-CrDtN1yF.js +0 -1
  678. package/dist/web/assets/client-links-store-B7VjTEfO.js +0 -1
  679. package/dist/web/assets/combobox-BOXLFvvr.js +0 -1
  680. package/dist/web/assets/console-BB2sTsSs.js +0 -1
  681. package/dist/web/assets/context-menu-DW29av0t.js +0 -1
  682. package/dist/web/assets/dropdown-menu-C0AuLdFm.js +0 -1
  683. package/dist/web/assets/fla-mention-D_Qb7VeY.js +0 -1
  684. package/dist/web/assets/index-CSV9nk7P.js +0 -2
  685. package/dist/web/assets/index-DFt6UfTv.css +0 -1
  686. package/dist/web/assets/label-table-BUAeArKh.js +0 -1
  687. package/dist/web/assets/model-4BHOc7rR.js +0 -1
  688. package/dist/web/assets/model-CxmTkWuw.js +0 -1
  689. package/dist/web/assets/motion-TN6JdrrU.js +0 -1
  690. package/dist/web/assets/occupation-catalog-C3Hj8p4a.js +0 -1
  691. package/dist/web/assets/person-profile-Cmkd1uXt.js +0 -1
  692. package/dist/web/assets/popover-DyX7FE_t.js +0 -1
  693. package/dist/web/assets/profile-model-CmC9A3we.js +0 -1
  694. package/dist/web/assets/quick-edit-api-D6Xgntqh.js +0 -1
  695. package/dist/web/assets/radio-group-AkUGYCQ8.js +0 -1
  696. package/dist/web/assets/roundtable-live-C1wc_F30.js +0 -1
  697. package/dist/web/assets/save-file-rPduHi2f.js +0 -1
  698. package/dist/web/assets/select-CuhUd9VL.js +0 -1
  699. package/dist/web/assets/shared-report-BKhY4rtE.js +0 -3
  700. package/dist/web/assets/tabs-B8ccOT5z.js +0 -1
  701. package/dist/web/assets/ui-CoUaCzmO.css +0 -1
  702. package/dist/web/assets/ui-Pf0_u3Mo.js +0 -1
  703. package/dist/web/assets/useAgentWorkSummary-CNoUxwOW.js +0 -1
  704. package/dist/web/assets/useForwardScopeId-Bzm9IM9h.js +0 -1
  705. package/dist/web/assets/useKnowledgeItemPeek-24H5cZzL.js +0 -1
  706. package/dist/web/assets/useTeamPeople-IATXewrX.js +0 -1
  707. package/dist/web/assets/utils-_mWlJRpS.js +0 -1
  708. package/dist/web/assets/version-Cw272WBv.js +0 -1
  709. package/src/workspace-protocol/array-validation.js +0 -19
  710. package/src/workspace-protocol/base64url-contract.js +0 -27
  711. package/src/workspace-protocol/constants.js +0 -37
  712. package/src/workspace-protocol/error-contract.js +0 -24
  713. package/src/workspace-protocol/fact-contract.js +0 -110
  714. package/src/workspace-protocol/governance-contract.js +0 -47
  715. package/src/workspace-protocol/index.js +0 -53
  716. package/src/workspace-protocol/json-budget.js +0 -19
  717. package/src/workspace-protocol/manifest-contract.js +0 -186
  718. package/src/workspace-protocol/publication-contract.js +0 -212
  719. package/src/workspace-protocol/query-contract.js +0 -149
  720. package/src/workspace-protocol/scalar-contract.js +0 -192
  721. package/src/workspace-protocol/sync-contract.js +0 -184
  722. package/src/workspace-protocol/text-contract.js +0 -39
  723. package/src/workspace-protocol/validation.js +0 -66
  724. /package/dist/web/assets/{UiNotice-ZCBdABdM.css → UiIconButton-ZCBdABdM.css} +0 -0
  725. /package/dist/web/assets/{settings-restart-BU_GGtbG.css → settings-autosave-BU_GGtbG.css} +0 -0
package/README.md CHANGED
@@ -1,1033 +1,223 @@
1
1
  <p align="center">
2
2
  <picture>
3
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/mark/fuli-mark-dark.svg" />
4
- <img src="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/mark/fuli-mark-color.svg" alt="Fuli logo" width="72" />
3
+ <source media="(prefers-color-scheme: dark)" srcset="brand/svg/lockup/fuli-lockup-bilingual-horizontal-dark.svg" />
4
+ <img src="brand/svg/lockup/fuli-lockup-bilingual-horizontal.svg" alt="FULI 复利 logo" width="200" />
5
5
  </picture>
6
6
  </p>
7
7
 
8
- <h1 align="center">Fuli</h1>
8
+ <p align="center">
9
+ <picture>
10
+ <source media="(prefers-color-scheme: dark)" srcset="docs/readme/hero-en-dark.webp" />
11
+ <img src="docs/readme/hero-en.webp" alt="FULI 复利: your AI tools share one memory of you and your projects" width="800" />
12
+ </picture>
13
+ </p>
14
+
15
+ <p align="center">FULI is a plugin that lets your tasks move across all your Agent clients: Claude Code, Codex, OpenCode… They share one memory, one taste and one FLA team, so you use whichever fits and switch without explaining everything again. It doesn't replace your clients or change what you set up: your models, subscriptions, sessions and settings stay as they are. FULI plugs in as its own entries only, and removing it from a client in the console, or uninstalling FULI, takes those entries out again.</p>
16
+
9
17
 
10
18
  <p align="center">
11
- English · <a href="README.zh-CN.md">简体中文</a>
19
+ English · <a href="README.zh-CN.md">简体中文</a> · <a href="https://有点.意思.com/fuli/">Website</a> · <a href="https://github.com/JevonsCode/fuli/releases/latest">Download</a>
12
20
  </p>
13
21
 
14
22
  <p align="center">
23
+ <a href="https://github.com/JevonsCode/fuli/releases/latest"><img src="https://img.shields.io/github/v/release/JevonsCode/fuli?style=flat&label=desktop" alt="latest release" /></a>
15
24
  <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/v/fuli-context?style=flat&logo=npm&label=fuli-context" alt="npm version" /></a>
16
- <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/dm/fuli-context?style=flat" alt="npm downloads" /></a>
25
+ <a href="https://github.com/JevonsCode/fuli/releases"><img src="https://img.shields.io/github/downloads/JevonsCode/fuli/total?style=flat&label=desktop%20downloads" alt="desktop downloads" /></a>
26
+ <a href="https://www.npmjs.com/package/fuli-context"><img src="https://img.shields.io/npm/dm/fuli-context?style=flat&label=npm%20downloads" alt="npm downloads" /></a>
17
27
  <a href="LICENSE"><img src="https://img.shields.io/npm/l/fuli-context?style=flat" alt="license" /></a>
18
28
  </p>
19
29
 
20
- **Switch AI tools. Keep yourself**
21
-
22
- Fuli (复利) is Chinese for **compound interest**: returns that generate further returns.
23
-
24
- Fuli exists to preserve your own taste, personality, and judgment as you work with AI.
25
- We believe people should no longer be tied to doing everything themselves. You should
26
- be free to make decisions, come up with ideas, and take a break.
27
-
28
- Fuli works with Codex, Claude Code, and other agent clients that support MCP and Skills.
29
- Connect supported clients to the same Fuli data and continue with the same agent,
30
- carrying forward its recorded work and relevant context.
31
-
32
- As AI learns to take on more of the work, Fuli helps you make the transition while
33
- keeping your own judgment at the center.
34
-
35
- Fuli is a collaboration layer for long-lived agents across MCP-compatible AI clients. Connect
36
- your tools to the same accessible Fuli data, select the same agent, and continue with its identity,
37
- project responsibilities, and relevant working context. Use `fuli connect` for standard MCP
38
- configuration, or automatic setup where a client adapter is available (Codex, Claude Code, Cursor, and Claude
39
- Desktop with a compact chat tool profile). See [client connections](docs/client-connections.md).
40
-
41
- - **A lasting teammate:** keep an agent's role, collaboration history, and working memory between tasks.
42
- - **Context with boundaries:** retrieve relevant project knowledge, decisions, and preferences with
43
- their sources, scope, and confirmation status.
44
- - **A team when needed:** coordinate specialist agents and record actual worker execution through
45
- an available, authorized host client or executor.
46
- - **Every task has an owner:** ask for work inside a project directory; Fuli registers the project
47
- and staffs a lead agent. The reply ends with who led and who helped.
48
- - **Three built-in specialists:** Jefa manages projects, Bole handles AR (Agent Resources) for
49
- recruiting and staffing, and Tonborg helps with judgment. Every space starts with all three.
50
- - **Judgment guided by your preferences:** [Tonborg](docs/judgment-and-autonomy.md) reviews items
51
- within your chosen autonomy level and recommends clients and models. Each decision has a log;
52
- a thumbs up, thumbs down or short reason helps guide future judgments.
53
- - **Agents talk to each other:** through the [Roundtable](#agent-roundtable), one agent asks another
54
- conversation directly, and every exchange is recorded.
55
-
56
- “Long-lived” means persistent identity and context. Fuli assembles that context and coordinates
57
- work; the connected AI tools run it. Client adapters determine which conversations can be captured
58
- and resumed. Connecting another tool does not grant access to another project's private memory.
59
-
60
- Fuli separates private conversation journals, agent working memory, and confirmed knowledge so
61
- ongoing collaboration produces reusable understanding. AI retrieves, summarizes, warns, and
62
- executes; humans retain final authority.
63
-
64
- Explore the [product website](https://有点.意思.com/fuli/).
65
-
66
- ## Start here
67
-
68
- Install Fuli, connect a client, and run one actual tool call to verify the connection. See
69
- [Installation](#installation) for full requirements and [client connections](docs/client-connections.md)
70
- for configuration formats, Hooks, and troubleshooting.
71
-
72
- Humans retain login, Hook trust, and manual review. **Settings showing `Connected` (`connected`)
73
- only means the current Fuli entry is present in the client's configuration file — it does not prove
74
- that the client loaded the MCP process, that a Hook delivered context, or that a tool call
75
- succeeded.**
76
-
77
- ### 1. Install
78
-
79
- Pick one of two ways:
80
-
81
- - **Download the app (recommended, Windows):** get `FULI-Setup-<version>.exe` from the
82
- [latest release](https://github.com/JevonsCode/fuli/releases) and double-click it. No terminal,
83
- no administrator rights; Node.js, Java and the graph database are built in. On first launch FULI
84
- finds the AI clients on your computer and connects them in one click, and offers start at login.
85
- If FULI is already installed, the setup updates it and keeps your data. The installer is not
86
- code-signed yet, so Windows may show "Windows protected your PC": choose "More info → Run anyway".
87
- - **Download the app (macOS, Apple silicon):** get `fuli-macos-arm64-<version>.dmg` from the same
88
- release, open it and drag FULI.app to Applications. macOS 13.5 or later; Intel Macs use the terminal
89
- install. The app is not signed yet: the first time it is blocked, open System Settings › Privacy &
90
- Security and choose "Open Anyway". See [docs/macos-app.md](docs/macos-app.md).
91
- - **Install from the terminal:** for developers, and for macOS / Linux.
92
-
93
- With Node.js 24.12+ and Docker Compose v2 available (default container mode; see
94
- [Installation](#installation) for macOS/Linux native mode), run:
95
-
96
- ```bash
97
- npm install --global fuli-context
98
- fuli setup
99
- fuli open
100
- ```
101
-
102
- The setup wizard shows its plan before changing your environment.
103
-
104
- ### 2. Connect a client
105
-
106
- - **Detected Codex, Claude Code, Cursor, or Claude Desktop:** `fuli setup` writes the MCP entry and
107
- supported Hooks/Skills. Quit and reopen apps that read MCP configuration only at launch, then open
108
- a new task. Codex Hook trust requires manual `/hooks` review in Codex.
109
- - **Other MCP clients:** run `fuli connect` (or open **Settings → Client connection** in the
110
- console), merge the `fuli` entry into the client's MCP configuration while keeping other servers,
111
- and reload or trust the server in that client. `fuli connect` prints JSON only.
112
-
113
- ### 3. First actual tool call and verification
114
-
115
- 1. Run `fuli status` and confirm the management UI and personal graph are ready (default
116
- `http://127.0.0.1:2727`).
117
- 2. Confirm Fuli tools appear in the client and **make one actual tool call** inside a project
118
- directory (for example, ask the Agent to load project collaboration preferences or coordinate a
119
- small task). Verify that Fuli resolves the right project (or registers/staffs a lead Agent) and
120
- asks for missing context rather than inventing it.
121
- 3. Optional cross-tool handoff: use the Agent's continuation instruction in another client
122
- connected to the same data and verify that it recovers the same Agent, project, and prior work.
123
- See [Agent conversations and collaboration](docs/agent-conversations-and-collaboration.md).
124
-
125
- For a one-off task, this source version also supports an isolated **temporary project** when no
126
- registered project matches; reading preferences alone creates nothing, and an ambiguous project
127
- still needs a choice. Fuli retains its task history and follows the existing Agent recruitment and
128
- executor permissions. The Agent directory explains the first-task entry, and task details show a
129
- completion table only after real worker execution is reported — an assigned Agent or an ordinary
130
- local conversation alone is not worker evidence.
131
-
132
- ### 4. Troubleshooting
133
-
134
- If setup, client detection, or tool calls fail, see
135
- [Common failure recovery](docs/client-connections.md#common-failure-recovery). Use
136
- `fuli setup --yes --connected-only` only to refresh clients that still have an existing Fuli MCP
137
- entry (**Connected** / `connected` or **Configuration changed** / `changed` in Settings); clients
138
- showing **Skills only** (`skills_left`), **Removed** (`removed`), **Not connected**
139
- (`not_connected`), or newly installed clients without a Fuli MCP entry require a full `fuli setup`.
140
-
141
- [How it works](#philosophy) · [Installation](#installation) ·
142
- [Agent roles and teams](docs/employee-agents.md) ·
143
- [Cross-client acceptance](acceptance/cross-client-handoff.md) · [Contribute](CONTRIBUTING.md) ·
144
- [Report an issue](https://github.com/JevonsCode/fuli/issues/new/choose)
145
-
146
- ## Agent Roundtable
147
-
148
- Agents talk to each other directly, the way a lead asks a teammate or a sub-agent. A Codex
149
- Agent can ask the Agent behind a specific Claude Code conversation, or a FULI Agent that has
150
- never run yet. Nobody creates rooms or invites participants: an Agent calls `message_agent`,
151
- Fuli wakes the recipient read-only in its own client and returns its answer: Claude Code
152
- forks the conversation; Codex records the exchange in it (or uses a new session while it is
153
- open in the app). A message that cannot be delivered waits in the recipient's inbox for its
154
- next task.
155
-
156
- Agents can also keep direct and group chats with `agent_chat`. Messages are pushed: an Agent
157
- that calls `wait` gets new messages at once, and a direct message or an `@` mention wakes an
158
- Agent that is not waiting. Chats only carry communication; they never change knowledge weights.
159
-
160
- Every exchange is kept locally; the console's Roundtable page shows who asked whom, through
161
- which client, and exactly what was said. Tools and limits: [Agent Roundtable](docs/agent-roundtable.md).
162
-
163
- ## npm packages
164
-
165
- | Package | Status | Intended use |
166
- | --- | --- | --- |
167
- | [`fuli-context`](https://www.npmjs.com/package/fuli-context) | Available | Personal edition; personal knowledge, the graph database, and the management UI all run locally |
168
- | Fuli Server npm package | In development | A separate server for team-shared deployments; not yet published |
169
-
170
- `fuli-context` is currently the only available npm package. The shared layer never contains
171
- personal taste, personality, or judgment preferences.
172
-
173
- ## Philosophy
174
-
175
- ### 1. Measure reuse value, not knowledge volume
176
-
177
- Fuli is built around one question:
178
-
179
- > Without Fuli, would the agent have to relearn information that is confirmed, still valid, and
180
- > relevant to the current task?
181
-
182
- Node count, transcript count, and graph size are not success metrics. The product succeeds when a
183
- past collaboration asset is reused within the correct project, time, provenance, and authority
184
- boundaries—and reduces repeated explanation, correction, or rework.
185
-
186
- ### 2. Review every task; do not retain every task
187
-
188
- A task may produce:
189
-
190
- - reusable knowledge such as API conventions, runbooks, release procedures, or constraints;
191
- - experience explaining why an approach worked or failed;
192
- - a decision trace with options, a human choice, rationale, and later validation;
193
- - judgment aids such as preferences, principles, taste, or personality tendencies.
194
-
195
- It may also produce only disposable output, a guess, or a one-off choice. In that case,
196
- `retain_nothing` is the correct result. Every task should perform a knowledge-value checkpoint, but
197
- not every task must become stored knowledge.
198
-
199
- ### 3. Human authority outranks agent repetition
200
-
201
- An agent may discover candidates, surface conflicts, recommend promotion, or resolve a deferred
202
- conflict when explicitly authorized. It may not turn semantic similarity, repetition, or its own
203
- judgment into human confirmation. Shared-knowledge promotion and sensitive project mutations use a
204
- preview followed by an explicit, one-time, atomic action.
205
-
206
- ### 4. Assemble context, then retrieve evidence on demand
207
-
208
- Fuli does not inject the complete history at session start. The entry step always loads effective
209
- personal-global preferences, preferences from one exactly matched project, and explicitly
210
- propagating preferences from authorized parent projects. When the current task signals that a
211
- stable prior fact, method, URL, decision, release, deployment, or authentication runbook may matter,
212
- the same step also performs a small bounded recall from that project and its authorized knowledge
213
- sources. The agent uses focused on-demand search when more evidence is needed.
214
- Retrieval alone is not usage; a usage event is recorded only when an item materially affects an
215
- answer, implementation, or decision.
216
-
217
- ### 5. Preserve evolution instead of overwriting history
218
-
219
- An old approach may have been correct under earlier conditions and later replaced. Fuli preserves
220
- provenance, confirmation authority, time, rationale, revisions, supersession, and negative evidence
221
- so an agent can explain both what applies now and why the past was different. Negative feedback may
222
- lower rank or trigger review, but it never silently erases history.
223
-
224
- ### 6. Put shared knowledge in the parent; keep differences in each child
225
-
226
- For example, hotel and flight projects can keep their own PRDs, configuration, and domain rules,
227
- while a parent activity-platform project owns shared local-run, mock, test, and deployment runbooks:
228
-
229
- ```text
230
- Activity platform (parent: shared runbooks)
231
- ├── Hotel project (child: hotel PRD / configuration / overrides)
232
- └── Flight project (child: flight PRD / configuration / overrides)
233
- ```
234
-
235
- When an agent works in the hotel project, it searches hotel-local knowledge first, then follows
236
- explicit outgoing `PART_OF` or `USES_KNOWLEDGE_FROM` relationships to authorized sources, up to two
237
- hops. A child item with the same stable key overrides an inherited item. Project-scoped personal
238
- preferences remain exact by default; only preferences explicitly marked `descendants` or
239
- `selected_projects` may propagate over the same authorized relationships, with origin project,
240
- path, and distance preserved. Equally near parent conflicts require human judgment and are never
241
- resolved by weight. Generic `RELATED_TO` relationships do not expand scope automatically; search
242
- returns only a one-time read-only expansion suggestion that the Agent must ask the user to approve.
243
-
244
- Similar items from multiple children create only a common-knowledge candidate. A shared preference
245
- across projects without one common parent likewise creates only a personal-global candidate while
246
- preserving each source text, qualifier, and provenance. Current clustering is a lexical heuristic,
247
- not proof of semantic equivalence. A human must choose the content, scope, and rationale before it
248
- can apply.
249
-
250
- ### 7. Local first; no personal model in the shared layer
251
-
252
- The personal graph stays local by default. Supported client adapters can journal visible
253
- conversations for private agent continuity, separately from structured confirmed knowledge.
254
- Conversation recall is bounded, with a default seven-day inactivity window. Credentials, temporary
255
- logs, and raw command output must not enter the knowledge graph. The team-shared layer contains only
256
- confirmed project or domain knowledge with context and provenance—not personal taste, personality,
257
- or judgment preferences.
258
-
259
- ## Practical use: classification, scope, project resolution, and retrieval
260
-
261
- ### Decide what to store before deciding where to store it
262
-
263
- Content type and effective scope are independent dimensions. The first three rows are personal
264
- collaboration preferences and carry a `profileAspect`. Project facts have no `profileAspect` and do
265
- not appear on the Personal preferences page.
266
-
267
- | Type | What belongs here | Example |
268
- | --- | --- | --- |
269
- | Taste (`taste`) | Outcomes, styles, and quality directions the user explicitly likes or rejects across UI, writing, product, architecture, or engineering work | “Use fewer large gradients and avoid cards nested inside cards.” |
270
- | Personality (`personality`) | A stable working or collaboration trait explicitly described by the user | “I communicate directly and want the Agent to move work forward proactively.” |
271
- | Judgment preference (`judgment_preference`) | Decision conditions, priorities, risk posture, and operational boundaries used when making trade-offs | “Discuss directional ambiguity first; never `git push` without explicit authorization.” |
272
- | Project knowledge | Reusable objective facts, terminology, requirements, routes, APIs, architecture, rationale, and runbooks | “A GitHub Release triggers Fuli's npm publication.” |
273
-
274
- Four questions provide a quick classifier: “What outcome do I want?” is taste; “How do I work over
275
- the long term?” is personality; “How do I decide under a trade-off?” is judgment preference; and
276
- “How does this system objectively work?” is project knowledge. One-off commands, temporary output,
277
- unverified guesses, raw chat, and credentials are not promoted into confirmed knowledge.
278
-
279
- Personality is not a catch-all category for everything learned about a person. Only an explicit,
280
- stable self-description can be confirmed with a human basis. A personality inferred by an Agent
281
- from one behavior must remain `pending`; it cannot masquerade as human-confirmed. An empty
282
- Personality filter on `/preferences` therefore usually means there is no qualifying item in the
283
- selected scope, not that capture failed. “Keep copy concise” is more likely taste, while “do not
284
- push without authorization” is more likely a judgment preference. To make the intent explicit,
285
- say: `This is a long-term collaboration trait; save it as a personal-global personality preference: I communicate directly.` An Agent-inferred candidate can be confirmed, corrected, or invalidated
286
- by the user from `/preferences` or `/flreview`.
287
-
288
- ### Personal-global, project-scoped, and shared
289
-
290
- | Scope | When to use it | Key write fields | Retrieval rule |
291
- | --- | --- | --- | --- |
292
- | Personal-global preference | The behavior should remain the same in unrelated projects | `targetKind: "personal"`; omit `personalProjectId`; set `profileAspect` | Loaded for every task |
293
- | Project-scoped personal preference | The collaboration behavior belongs to one project or project family | Same fields plus the exact `personalProjectId`; default to `local_only` and never inherited by child projects; explicitly use `descendants` or `selected_projects` when propagation is intended | Exact project wins; propagation follows only the explicit inheritance mode and authorized relationships, and score never resolves a conflict automatically |
294
- | Project knowledge | A fact belongs to one project or to a designated parent/source project | `targetKind: "personal"`; set `personalProjectId`; omit `profileAspect` | Search the current project first, then authorized `PART_OF` / `USES_KNOWLEDGE_FROM` sources up to two hops |
295
- | Team-shared knowledge | Human-confirmed project or domain knowledge genuinely needed by a team | `targetKind: "project"` after preview/review | Visible only from explicitly selected or subscribed public projects; personal preferences never enter this layer |
296
-
297
- To choose a preference scope, ask: **Should this change the Agent's behavior in a completely
298
- unrelated project?** If yes, use personal-global. If it applies only to Fuli, use a project-scoped
299
- preference. If it applies to a project family, keep it project-scoped and explicitly choose whether
300
- it may propagate to descendants. Do not turn an objective project fact into a personal-global item
301
- merely because more than one project may reuse it. Put it in an explicit parent or knowledge-source
302
- project and add a directional authorization relation. When global and project-scoped variants have
303
- the same stable `attributes.preferenceKey`, human/source confirmation authority is resolved first;
304
- at equal authority, the exact project variant overrides the global one.
305
-
306
- ### How Fuli identifies the current project
307
-
308
- Fuli matches only stable `project_id` values already registered under Personal projects; it does
309
- not guess from fuzzy directory similarity. Normally the `project_id` matches the repository
310
- directory name, so `/workspace/fuli` maps to `fuli`. Standard calls pass only the current working
311
- directory, and resolution follows this order:
312
-
313
- 1. Find the nearest Git repository root, read its `origin` remote from its `.git/config` (a
314
- worktree's common directory) and match it exactly to one registered project's recorded
315
- repository source URL; ssh and https forms of the same repository are equal. Any clone or
316
- worktree therefore resolves to its project (`git_remote`), whatever its folder is called.
317
- 2. Otherwise match the repository directory name exactly to a registered `project_id`; for a
318
- Codex worktree, the original repository ID from its `.git` pointer. A project that records a
319
- different repository source is never matched by name (`repository_remote_conflict`).
320
- 3. Match the current directory name exactly to a registered project ID.
321
- 4. At a workspace root, match one registered direct child only when exactly one child contains
322
- `.git`, `package.json`, `pyproject.toml`, `Cargo.toml`, or `go.mod`.
323
- 5. Multiple candidates return `ambiguous`; no candidate returns `unmatched` (a remote recorded by
324
- several projects counts as several). Neither state applies project preferences or guesses a project.
325
-
326
- For an unregistered repository with an unambiguous identity, the installed capture skill may call
327
- `upsert_personal_project` before the first project-scoped write to create a minimal local private
328
- project. It never creates or subscribes to a public project automatically. If a workspace has
329
- multiple candidates, run the Agent from the exact project directory or explicitly register and
330
- select the project first.
331
-
332
- ### Which tool the Agent calls and when
333
-
334
- Normal use does not require manual MCP calls: submit a task to the Agent from the project directory.
335
- Fuli includes lifecycle adapters for Claude Code, Codex, and Cursor. When a loaded, trusted entry
336
- hook supplies `begin_task_context` context, use it without repeating the fallback. Cursor's adapter
337
- starts the durable task through a hook but relies on the Agent to retrieve preferences and role
338
- context. When no hook context was supplied, call the following once at task entry:
339
-
340
- ```json
341
- {
342
- "tool": "get_collaboration_preferences",
343
- "arguments": {
344
- "projectPath": "/workspace/fuli",
345
- "taskPrompt": "Fix npm publishing and reuse this project's existing release conventions."
346
- }
347
- }
348
- ```
349
-
350
- The important part of a matched response resembles:
351
-
352
- ```json
353
- {
354
- "context": {
355
- "personal_project_id": "fuli",
356
- "project_resolution": {
357
- "status": "matched",
358
- "basis": "repository_root",
359
- "personal_project_id": "fuli"
360
- }
361
- },
362
- "effective_preferences": ["personal-global preferences + exact fuli preferences"]
363
- }
364
- ```
365
-
366
- If entry-time `task_knowledge_recall` did not answer a stable project fact, search with one to four
367
- short queries centered on an action, artifact, target system, or identifier. Do not use the full
368
- user request verbatim as the only query:
369
-
370
- ```json
371
- {
372
- "tool": "search_current_project_knowledge",
373
- "arguments": {
374
- "projectPath": "/workspace/fuli",
375
- "queries": ["npm publication runbook", "GitHub Release trigger"],
376
- "includePending": false
377
- }
378
- }
379
- ```
380
-
381
- At task end, hook mode calls `checkpoint_task_knowledge`: use `capture_candidates` only for a small,
382
- durable, evidence-backed batch; otherwise use `retain_nothing`. A prompt-fallback Agent applies the
383
- same rule and writes through `capture_session_knowledge`. Personal preferences set the correct
384
- `profileAspect` and stable `attributes.preferenceKey`; project facts omit `profileAspect`. If
385
- automatic capture is disabled under Settings, automatic writes return `capture_disabled` and no
386
- category is created: transcripts, checkpoints, knowledge and preference candidates, knowledge usage,
387
- view records, and feedback or corrections reported through an Agent all stop. If the capture
388
- settings cannot be read, automatic writes stop the same way (`reason: policy_unavailable`). Edits
389
- you submit yourself in the FULI console and an explicit `新项目:` request still save, and reading
390
- existing knowledge keeps working. Session turns written while automatic recording is off are skipped
391
- with a content-free marker and are never imported after it comes back on.
392
-
393
- Capture can also be limited to projects. `projectMode` is `all` (the default), `all_except` with
394
- `excludedProjectIds`, or `selected` with `selectedProjectIds`; `unregisteredDirectories`
395
- (`skip` by default under `selected`, `capture` otherwise) decides work outside every registered
396
- project. A directory resolves to its project the same way task entry does, so a worktree of a
397
- repository is that repository's project. A project that is not recorded returns
398
- `reason: project_off`, an unregistered directory `project_unregistered`, and every task receipt
399
- ends with the reason and that explicit edits still save, for example
400
- `此项目未开启记忆;你明确提交的修改仍会保存`. Switching a project off never hides or
401
- deletes what it already recorded; `projectsOffSince` keeps when it stopped. Agents read the
402
- settings with `get_capture_policy` (pass `projectPath` to learn about the current project) and
403
- change them with `update_capture_policy` only after restating the change and getting the user's
404
- confirmation; the settings page uses `PATCH /api/capture-policy`. Saying "这次别记" in a session pauses
405
- only that session at once, without a confirmation: the Agent calls `update_capture_policy` with just
406
- `sessionPaused: true` and its `taskContextToken`, and every later receipt in the session says
407
- `本会话已暂停记录(自 HH:mm 起)` (`reason: session_paused`). Earlier records stay, workers the session
408
- starts are paused with it, "继续记" (`sessionPaused: false`) resumes from then on, and nothing written
409
- while paused is recorded later. The pause lives in the local runtime directory and ends with the session.
410
-
411
- To turn FULI off for one session altogether, the person types `/fuli stop` (Claude Code and Cursor, where
412
- setup installs the `fuli` command Skill) or `fuli stop` (any client; Codex accepts no custom slash command).
413
- The prompt hook answers the line itself, so the model never sees it: from then on that session gets no
414
- injected memory, preferences or recall, its Agent's own FULI reads (searches, Agent memory, conversations)
415
- are refused, it records nothing and starts no collaboration (workers, loans, other Agents, role work), while other sessions, the local service and existing memories stay as they are.
416
- `fuli start` turns it back on within the existing settings (a pause or a stricter global, client or project
417
- setting still applies), `fuli restart` also gives the next turn the full context again, and `fuli status`
418
- shows the session and the default; nothing said while FULI was off is recorded later. Context already sent
419
- to the model cannot be taken back, so isolation needs a new session. Only a task token shows which session a
420
- tool call is for (Claude Code keeps its tool connection across /clear; Codex and Cursor connections name no
421
- session), so while any session of a client is off FULI refuses that client's tool calls without a task token,
422
- rather than serve memory to a session that may be the stopped one. Agents pass the `taskContextToken` they
423
- already have (entry, searches and team reads take it), so other windows keep working. The same switch runs from a shell the
424
- client started (`!fuli session stop`), so an Agent with shell access can run it too (the same trust as
425
- access to your files); the console and `fuli mcp --call` still read for you, and `fuli session default off` makes new sessions start with FULI
426
- off until started; sessions already open keep theirs.
427
-
428
- Run these local contract tests to check that the README and project-path behavior still match the
429
- implementation:
430
-
431
- ```bash
432
- npm run test:node -- test/acceptance-docs.test.js test/project-path-context.test.js
433
- ```
434
-
435
- ## Agent interaction sequence
436
-
437
- This is the simplified lifecycle for a normal task. The Chinese
438
- [detailed sequence diagram](acceptance/智能体调用时序图.md) also covers inheritance, usage counting,
439
- write previews, and source markers.
30
+ <h3 align="left">Automate everything that can be automated, and hand the execution to your FLAs. You make the calls and lead the way: take your FLA crew through the hard parts, or go grab a coffee and enjoy the compound interest of your own experience.</h3>
31
+
32
+ <p align="left">Project profiles and FLA hiring run on their own if you'd rather not think about them; your only job is to set the direction. FLAs carry context and tools across every Agent client, and both top-tier and lighter models pull their weight here.</p>
33
+
34
+
35
+
36
+ Each task gets only the small slice it needs. Your judgment and experience keep adding up, so FULI
37
+ knows you better the more you use it. That is the compound interest. Little by little, what your
38
+ AI makes starts to carry your taste.
39
+
40
+ ## What FULI does
41
+
42
+ <table>
43
+ <tr>
44
+ <td width="50%" valign="top">
45
+ <img src="docs/readme/card-memory-en.webp" alt="Claude Code, Codex and OpenCode connected to one FULI" width="460" />
46
+ <h3 align="center">One memory for every client</h3>
47
+ Connect Claude Code, Codex, OpenCode or Cursor with one click. A rule you stated in one of them is there in the others.
48
+ </td>
49
+ <td width="50%" valign="top">
50
+ <img src="docs/readme/card-team-en.webp" alt="Three FLAs review a fix together in the roundtable" width="460" />
51
+ <h3 align="center">A team of FLAs, talking at a roundtable</h3>
52
+ Each project gets a lead Agent (an FLA) with a name, a job and its own working memory; several FLAs form a group when the work needs it. They review, test and hand work over to each other in the roundtable, and you can read every turn.
53
+ </td>
54
+ </tr>
55
+ <tr>
56
+ <td width="50%" valign="top">
57
+ <img src="docs/readme/card-tonborg-en.webp" alt="Knowledge waiting to be confirmed, with Tonborg's switch" width="460" />
58
+ <h3 align="center"><img src="docs/readme/fla-tonborg-inline.webp" alt="" width="28" align="absmiddle" /> Tonborg confirms for you</h3>
59
+ New knowledge waits for a yes. Switch on Tonborg and it confirms everyday items by your preferences, asks you when it is unsure, writes down each reason, and learns from a thumbs up or down.
60
+ </td>
61
+ <td width="50%" valign="top">
62
+ <img src="docs/readme/card-tokens-en.webp" alt="Tokens per successful task: 0.81 times with FULI" width="460" />
63
+ <h3 align="center">Fewer tokens per finished task</h3>
64
+ Measured for the upcoming 0.25.0: a successful task with FULI takes 0.81× the tokens of the same task without it, and 70 of 72 tasks pass. The saving comes from facts that live in your words, not in the code.
65
+ </td>
66
+ </tr>
67
+ </table>
68
+
69
+ Four FLAs come built in:
70
+
71
+ <table>
72
+ <tr>
73
+ <td width="25%" align="center" valign="top">
74
+ <img src="docs/readme/fla-jefa.webp" alt="Jefa" width="96" /><br />
75
+ <b>Jefa</b> is your project manager.
76
+ </td>
77
+ <td width="25%" align="center" valign="top">
78
+ <img src="docs/readme/fla-bole.webp" alt="Bole" width="96" /><br />
79
+ <b>Bole</b> hires FLAs and staffs each project.
80
+ </td>
81
+ <td width="25%" align="center" valign="top">
82
+ <img src="docs/readme/fla-tonborg.webp" alt="Tonborg" width="96" /><br />
83
+ <b>Tonborg</b> confirms for you and recommends clients and models.
84
+ </td>
85
+ <td width="25%" align="center" valign="top">
86
+ <img src="docs/readme/fla-astro.webp" alt="Astro" width="96" /><br />
87
+ <b>Astro</b> takes conversations that belong to no project yet.
88
+ </td>
89
+ </tr>
90
+ </table>
91
+
92
+ ## How it works
440
93
 
441
94
  ```mermaid
442
- sequenceDiagram
443
- autonumber
444
- actor U as User
445
- participant A as Agent
446
- participant L as Lifecycle integration
447
- participant F as Fuli MCP
448
- participant G as Local graph
449
-
450
- U->>A: Submit a task in the current project
451
- alt Claude Code / Codex (hook context supplied)
452
- L->>F: begin_task_context(projectPath, taskPrompt)
453
- F-->>A: Preferences, exact project, bounded recall, and task token
454
- else No hook context (prompt fallback, including Cursor)
455
- A->>F: get_collaboration_preferences(projectPath, taskPrompt)
456
- F-->>A: Preferences, exact project, and bounded recall
457
- end
458
-
459
- A->>A: Inspect task_knowledge_recall
460
- opt Historical context is needed and recall did not answer it
461
- A->>F: search_current_project_knowledge with focused queries
462
- F->>G: Search child first, then authorized parents
463
- G-->>A: Bounded content, status, provenance, and history
464
- opt Knowledge materially affects the result
465
- A->>F: record_knowledge_usage
466
- end
467
- end
468
-
469
- A->>A: Complete the implementation, validation, or answer
470
- opt The task creates a decision, contradiction, or stale signal
471
- A->>F: Record rationale or knowledge feedback
472
- end
473
- opt Something is worth keeping (candidates, a decision, a meaningful work log)
474
- A->>F: checkpoint_task_knowledge
475
- F->>G: capture_candidates
476
- end
477
-
478
- alt Loaded and trusted Claude Code / Codex Stop hook
479
- L->>F: verify_task_checkpoint
480
- F-->>L: Close a routine task as retain_nothing / reported, otherwise remind
481
- else Cursor or an Agent without a Stop hook
482
- Note over A,F: Same contract. A routine fallback task closes at the next task entry
483
- end
484
- A-->>U: Return the result and any Fuli sources actually used
95
+ flowchart LR
96
+ U[You] -->|ask inside a project| A[Agent client]
97
+ A -->|task starts| F[FULI on your computer]
98
+ F -->|preferences and a small recall| A
99
+ A -->|look up more if needed| F
100
+ A -->|write back what is reusable| F
485
101
  ```
486
102
 
487
- ## Read-only external knowledge
488
-
489
- One knowledge-base connection can be bound to one or more existing personal projects without
490
- granting Fuli write access to the source. Each target keeps independent retrieval mode, sync
491
- cursor, and error state. The Connections page supports multi-project assignment, connection
492
- checks, manual synchronization, disconnection, and a per-project conflict switch.
493
-
494
- | Connector | Read path | Current boundary |
495
- | --- | --- | --- |
496
- | MCP | Resources `list/read`; configured `search` / `fetch` tools | Default; HTTPS or loopback HTTP, plus stdio |
497
- | Notion | Page Markdown and Data Source queries | Current `2026-03-11` API; explicit page or data-source IDs |
498
- | Feishu / Lark | Wiki nodes, search, and Docx raw content | Docx text only; search may require a user access token |
499
- | RAG Retrieval API | Dify-compatible external-knowledge retrieval contract | Live only; for compatible endpoints or adapters in front of systems such as RAGFlow |
500
- | Trusted custom code | Local ESM `sync` / `retrieve` contract | Explicitly installed trusted code, not a sandbox |
501
-
502
- <a id="connect-external-knowledge"></a>
503
-
504
- ### Connect one or more knowledge bases to a project
505
-
506
- One personal project can have multiple knowledge connections, and one connection can target
507
- multiple personal projects. Each submission adds a connection instead of replacing an existing
508
- one. Source configuration is stored once, while retrieval mode, synchronization state, and errors
509
- are isolated per target. Use Bind projects on an existing connection to add or remove targets.
510
-
511
- 1. Create or confirm the target under Personal projects.
512
- 2. If the source needs a token, set it in the environment that starts Fuli, then start or restart
513
- the service. The binding stores only the environment-variable name. For example, run
514
- `export PROJECT_KB_TOKEN='...'` and then `fl restart`.
515
- 3. Open `http://127.0.0.1:2727/connections`. Under External knowledge, enter a connection name,
516
- connector, one or more bound projects, and retrieval mode.
517
- 4. For MCP HTTP, enter the final endpoint URL (redirects to another origin are not followed) and an
518
- optional token environment-variable name. For MCP stdio,
519
- enter its command and arguments. For Notion, enter the token environment-variable name and Page
520
- IDs or Data Source IDs. For Feishu/Lark, enter the token environment-variable name, region, and
521
- an explicit Space ID, root-node token, or node tokens. For RAG Retrieval API, enter a
522
- Dify-compatible endpoint, knowledge-base IDs, and an optional token environment-variable name.
523
- A custom connector takes a trusted local ESM module and source JSON.
524
- 5. Select Add connection and then Check. A successful `mirror` or `hybrid` binding can be synced;
525
- a `live` binding reads its source when an Agent query runs.
526
- 6. After creation, use Bind projects to add or remove projects and select a mode per project.
527
-
528
- The project graph shows an External knowledge source node and a Uses external knowledge edge for
529
- each assignment. This is a read-only projection of connection configuration. Live bodies are still
530
- retrieved only when an Agent invokes `search_connected_knowledge`; showing the node does not mirror
531
- content locally.
532
-
533
- Retrieval modes differ as follows:
534
-
535
- - `live`: read the third party at query time without storing a body mirror in Fuli; the source must
536
- be available.
537
- - `mirror`: manually mirror read-only content into the bound personal project and query the graph.
538
- - `hybrid`: use both the local mirror and live source results; recommended when the connector
539
- supports both capabilities.
540
-
541
- Bindings support `live`, `mirror`, and `hybrid` modes. Mirror content is written only to the bound
542
- personal project as `observed`, `pending`, `restricted`, local-only knowledge. Credentials are read
543
- from named environment variables and are not stored in binding JSON. Source writes are never part
544
- of the connector contract. Documents that look like credential material are skipped individually,
545
- reported by count, and never enter the graph or Agent context.
546
-
547
- <a id="external-knowledge-conflict-policy"></a>
103
+ A task starts with the preferences in effect and a few related facts. The Agent looks up the rest
104
+ when it needs it, and at the end writes back only what the next task can reuse.
548
105
 
549
- ### Conflict policy
106
+ ## Install
550
107
 
551
- One default applies to every personal project; a project can keep its own choice as an exception
552
- (Connections → Conflict policy). The policy covers that project's personal graph, all external
553
- bindings, and explicitly selected public projects:
108
+ FULI runs a small service and a console on your own computer.
554
109
 
555
- - Ask in the Agent conversation is the built-in default. The Agent presents conflicting content,
556
- source, and scope separately so the user can choose.
557
- - Allow an Agent decision lets the Agent select the stronger or fresher source for the current
558
- response and requires it to explain the basis. It never confirms, invalidates, overwrites, or
559
- writes back any knowledge.
110
+ **Desktop client (recommended).** Download from the [latest release](https://github.com/JevonsCode/fuli/releases/latest):
560
111
 
561
- From the project directory, an Agent can be asked: `Search the current project and connected knowledge bases for the payment callback contract; list conflicting sources and ask me to decide.`
562
-
563
- `search_connected_knowledge` keeps personal-graph evidence, each external binding, and explicitly
564
- selected public projects as separate source sets. Public-project aggregation is **Beta**. When an
565
- Agent finds a material conflict, the default policy is to show it in the conversation and ask the
566
- user; the optional Agent-decision policy applies to the current response only and cannot confirm,
567
- invalidate, or rewrite any source. Direct external-to-public binding, reviewed public promotion,
568
- scheduled sync, webhooks, and full deletion reconciliation remain **TODO**.
569
-
570
- See the [external-knowledge architecture and connector contract](docs/external-knowledge-architecture.md), and the [public-workspace and personal-graph architecture](docs/public-personal-architecture.md).
571
-
572
- ## Current capabilities and evidence boundaries
573
-
574
- Core mechanisms covered by implementation and automated tests include:
575
-
576
- - a local personal space, exact project scope, and selective parent inheritance;
577
- - preference confirmation, deferred conflict resolution, revision history, and source markers;
578
- - bounded task-prompt recall, focused on-demand retrieval, and material-usage auditing;
579
- - task entry and completion checkpoints, plus local Claude Code, Codex, and Cursor lifecycle adapters;
580
- - decision options, rationale, and validation results supplied during initial capture;
581
- - knowledge-usage events, negative feedback, and content-generation isolation;
582
- - persistent scoped knowledge reviews with pause/resume watermarks;
583
- - common-knowledge discovery and preview-token-protected atomic promotion;
584
- - read-only multi-project MCP, Notion, Feishu/Lark, Dify-compatible RAG Retrieval API, and trusted-code bindings with connected retrieval.
585
-
586
- New in 0.20 (public preview `0.20.0-beta`, see the [release notes](docs/releases/0.20.0.md)):
587
-
588
- - **Projects and people**: unassigned conversations go to Astro, Jefa triages them, and when a topic keeps coming back (three conversations over at least two days) Astro asks whether to make it a project with its own people. Every project has a brief and every Agent an occupation, which Bole recruits by.
589
- - **Tasks**: assign without starting (backlog), and stop, retry, or review any run from the task details. A temporary failure is retried automatically only when no prompt was sent.
590
- - **Decisions**: an Agent that needs you asks in the conversation first. A request that must wait for you goes to the Decisions page, and your reply reaches the Agent that asked.
591
- - **Roundtable**: besides asks (`message_agent`), Agents have direct and group chats (`agent_chat`) with push delivery and `wait`; the console shows them live.
592
- - **Memory between projects**: weighted links (related, frequent, close) say how much one project may draw on another. Weights never grant access.
593
- - **Lower token cost**: a smaller task entry, shared rules read on demand, long preference lists read in pages, and a Stop hook that closes routine tasks without another model turn.
594
- - **Console**: six entries (Workbench, Agents, Conversations, Projects, Memory, Settings), a phone layout, and Alt/Option-click explanations for any status or term.
595
- - **Windows**: download `FULI-Setup-<version>.exe` from the release and double-click it to install for your user (no terminal, no administrator; unsigned for now, so SmartScreen asks once). The installed build has Update-Fuli, Rollback-Fuli, and Uninstall-Fuli that keeps your data; the console's 「Update to vX」 downloads the release's verified Windows package and runs the same update in one click.
596
-
597
- The following must not be presented as already proven:
598
-
599
- - the A/B thresholds in `FULI_ALIGNMENT_BENCHMARK.md` are acceptance conventions; claims that Fuli
600
- reduces explanation or rework require a sufficiently large set of controlled, real paired tasks;
601
- - benchmark projects and conversations are explicitly labeled **MOCK / synthetic data**, not user or
602
- production data;
603
- - the decision tool can include validation during initial capture, but it does not yet expose a
604
- dedicated operation for appending immutable validation results to an existing `Decision`;
605
- - Installed files do not prove host loading, trust, or execution. Claude Code and Codex adapters
606
- generate entry/Stop hook configuration; Codex trust review remains a user action. Cursor uses
607
- task-entry hooks and bounded Stop reminders, not an equivalent unconditional Stop gate. Ordinary
608
- input in each real client still requires live acceptance;
609
- - selected public projects in connected retrieval are Beta; external-to-public promotion and
610
- background delta synchronization are not implemented.
611
-
612
- ## Installation
613
-
614
- Requirements:
112
+ | System | File |
113
+ | --- | --- |
114
+ | Windows | `FULI-Setup-<version>.exe`. No terminal and no administrator rights. |
115
+ | macOS (Apple silicon, 13.5 or later) | `fuli-macos-arm64-<version>.dmg`. Drag FULI onto Applications. |
615
116
 
616
- - Node.js 24.12 or later;
617
- - the default container mode needs Docker Compose v2 through Docker Desktop, Rancher Desktop, or a compatible runtime;
618
- - macOS and Linux can use native mode without a VM; it requires Java 21 and `uv` (Python 3.12);
619
- - on a memory-constrained Mac, use
620
- `fuli setup --runtime-mode native --memory-profile low --adaptive-memory`. Container mode remains the compatibility default and is never changed automatically.
117
+ On first launch FULI finds the AI clients on this computer and connects each with one click. The
118
+ installers are not signed yet, so each system holds FULI back once; [Install and run](docs/install.md)
119
+ shows the two clicks that let it through.
621
120
 
622
- Install globally and initialize:
121
+ **Servers, VMs and the cloud.** Without a desktop, and on Intel Macs and Linux, install with npm
122
+ (Node.js 24.12 or later):
623
123
 
624
124
  ```bash
625
125
  npm install --global fuli-context
626
126
  fuli setup
627
- ```
628
-
629
- Or use the one-line installer, which checks the Node.js version first:
630
-
631
- ```bash
632
- curl -fsSL https://xn--8ovp9s.xn--m8txu.com/fuli/install.sh | sh
633
- ```
634
-
635
- On Windows PowerShell: `irm https://xn--8ovp9s.xn--m8txu.com/fuli/install.ps1 | iex`.
636
-
637
- `fuli setup` first shows its plan and asks for confirmation. It then checks the container runtime,
638
- initializes local Graphiti / Neo4j, creates a personal space, installs the companion Agent Skills,
639
- and registers the `fuli` MCP with detected agents. The default setup connects only the personal
640
- Provider; it does not simulate a team-shared service.
641
-
642
- Open the management UI after setup:
643
-
644
- ```bash
645
127
  fuli open
646
128
  ```
647
129
 
648
- The default URL is `http://127.0.0.1:2727`. On Windows, Hyper-V, WSL and winnat reserve port ranges that change
649
- between boots (`netsh interface ipv4 show excludedportrange protocol=tcp` lists them). A first setup picks ports outside
650
- those ranges. Every `fuli start`, `restart` and `setup` checks again: a Fuli port that is now reserved, or a console port
651
- Windows refuses or another program holds, moves to the nearest free port. Fuli backs up `runtime-settings.json`, saves
652
- the new port, starts normally and says so once (in the command output, the desktop client and the console). It never
653
- moves away from another running Fuli console on that port, and never starts a second one beside it. The Windows tray's
654
- **Use another port** still moves the console to a free port near the default on request.
655
- Open Agent sessions keep showing the old console address in Fuli links until they restart.
656
-
657
- The Settings page manages all seven local Fuli ports, graph runtime mode, LAN access, automatic capture,
658
- Agent access, UI language, and the resource refresh interval. Run `fuli restart` after saving port,
659
- runtime, or LAN changes;
660
- the refresh interval applies immediately. The same page polls real memory and disk usage for the
661
- management service, Providers, Neo4j, application files, and local data. Memory is sampled on every
662
- poll; disk usage is sampled at most once per minute, with separate timestamps. Missing container metrics
663
- are shown as partial instead of being replaced with mock values. Native Provider and Neo4j processes
664
- are included. Browser-tab memory is excluded; shared container-VM overhead is excluded in container mode.
665
-
666
- ## CLI
667
-
668
- The global package provides two equivalent commands: `fuli` and the short alias `fl`.
669
- CLI help, prompts, status output, and errors are always in English and do not follow the web or
670
- system locale. User data such as paths and space names is displayed unchanged.
671
-
672
- | Command | Purpose |
673
- | --- | --- |
674
- | `fuli --help` / `fuli -h` | List every public command and its available options |
675
- | `fuli --version` / `fuli -v` | Print the installed Fuli CLI version |
676
- | `fuli setup [options]` | Initialize the Provider, UI, agent integrations, and Skills; safe to rerun |
677
- | `fuli start [options]` | Check Agent integrations, then start the Provider and UI; optionally open a browser, rebuild containers, or enable LAN access |
678
- | `fuli stop [--data-dir DIR]` | Stop services without deleting data |
679
- | `fuli restart [options]` | Restart local services using the same runtime options as `start` |
680
- | `fuli status [--json] [--data-dir DIR] [--port PORT]` | Show UI, personal graph, and shared-service status; `--json` emits machine-readable output |
681
- | `fuli open [--data-dir DIR]` | Open the current management UI in the default browser |
682
- | `fuli graph export --output DIR [--mode container\|native]` | Export graph data as a checksummed, copyable offline bundle |
683
- | `fuli graph import --input DIR [--target-mode container\|native] [--yes]` | Verify and replace target graph data, preserving an automatic pre-import rollback bundle |
684
- | `fuli graph migrate --to native [--yes]` | Move a container graph to native mode, accepted only when node and relationship counts match |
685
- | `fuli update [setup options]` | Update the npm package and refresh local integrations |
686
- | `fuli uninstall [--yes] [--data-dir DIR]` | Remove agent integrations and services while preserving knowledge data and Neo4j volumes |
687
-
688
- Common commands:
689
-
690
- ```bash
691
- fuli --version
692
- fuli status
693
- fuli restart --rebuild
694
- fuli start --lan
695
- fuli graph export --output "$HOME/Backups/fuli-graph"
696
- fuli stop
697
- ```
698
-
699
- Connect a deployed `fuli-workspace` service:
700
-
701
- ```bash
702
- fuli connect-workspace \
703
- --url http://127.0.0.1:8789 \
704
- --token-file /path/to/private-token
705
- fuli restart
706
- ```
707
-
708
- The command verifies discovery, protocol version, and token scope before atomically updating the
709
- local runtime configuration with mode `0600`. It never prints the token, token-file path, or remote
710
- principal ID. Non-loopback services must use HTTPS. The current `fuli-workspace-v1` adapter enables
711
- discovery, explicit subscriptions, and queries; publishing, contributions, and review remain off
712
- until those protocol mappings are implemented.
713
-
714
- `start` and `restart` accept `--data-dir DIR`, `--personal-space NAME`, `--port PORT`, `--open`,
715
- `--rebuild`, `--lan`, and `--no-lan`. When port or LAN flags are omitted, the saved Settings values
716
- are used. LAN mode listens on private IPv4 addresses and prints the reachable URLs, the
717
- `fuli` username, and a temporary access code generated for that start. The default remains
718
- loopback-only; internal Providers and Neo4j ports are never exposed by `--lan`. LAN mode uses
719
- HTTP Basic Auth and is intended only for trusted home or office Wi-Fi, not public deployment.
720
- Before starting, `fuli start` performs a read-only check of detected Agent MCP, Skill, Codex bootstrap,
721
- and Claude lifecycle integrations. If any are missing or outdated, it still starts the local services
722
- and tells you to run `fuli setup`; it never applies setup changes implicitly.
723
-
724
- `setup` and `update` accept:
725
-
726
- | Option | Purpose |
727
- | --- | --- |
728
- | `--yes` | Skip confirmation for unattended setup |
729
- | `--codex-only` | Configure Codex only |
730
- | `--data-dir DIR` | Use a specific data and configuration directory |
731
- | `--personal-space NAME` | Set the personal-space name; defaults to `Personal` |
732
- | `--port PORT` | Set the management UI port; defaults to `2727` |
733
- | `--runtime-mode container\|native` | Select containers or native processes; defaults to `container`, with native mode currently on macOS/Linux |
734
- | `--memory-profile low\|balanced` | Select Neo4j's memory budget; fresh installs default to `balanced` |
735
- | `--adaptive-memory` | Enable on-demand wake and staged idle sleep, coordinated by the management service |
736
- | `--no-adaptive-memory` | Disable idle sleep and keep graph services running |
737
- | `--skip-agents` | Do not change agent configuration or Skills |
738
- | `--connected-only` | Refresh only clients that already have a Fuli MCP entry; used automatically by update |
739
- | `--no-start` | Initialize the Provider without starting the UI |
740
- | `--allow-provider-downgrade` | Accept a lower native Provider version, for example moving from a local `rc` build to a public `beta`; back up the data folder first |
741
- | `--personal-only` | Use only the personal Provider; this is the default |
742
- | `--with-dev-public` | Start a development shared Provider for local integration work only |
743
-
744
- The `low` profile uses a 128 MiB initial heap, 256 MiB maximum heap, and 64 MiB page cache.
745
- `balanced` uses 256 MiB, 512 MiB, and 256 MiB respectively. The low profile does not add a hard
746
- container memory limit: it lowers steady memory use while leaving room for Neo4j's native memory.
747
- It may cause more garbage collection and disk reads under bulk writes, large traversals, or high
748
- concurrency, but it does not change transaction semantics, storage format, or data volumes. If those
749
- workloads become slow or fail for lack of heap, run `fuli setup --memory-profile balanced --yes`.
750
- The selected profile is saved and reused by later setup, update, start, and restart commands.
751
-
752
- Adaptive memory is a lifecycle policy independent of the Neo4j memory profile. When enabled, the
753
- lightweight management service stays available. Real MCP tools, MCP resources, and graph requests
754
- acquire a runtime lease and wake services on demand. After the final lease is released, the personal
755
- Provider stops after 60 idle seconds by default and Neo4j stops after 180 idle seconds. Volumes are
756
- preserved and the next request restores the same data. Active calls renew their leases and cannot be
757
- interrupted by idle timers; a crashed client lease expires after at most 180 seconds. These durations
758
- are current product defaults, not measured hardware thresholds.
759
-
760
- This mode trades idle memory for first-request cold-start latency and additional disk reads. Health,
761
- runtime-status, and resource polling do not wake the graph, and `fuli status` treats intentional sleep
762
- as healthy. The management service must remain running to wake graph services, so `--no-start` only
763
- saves the policy for a later start. In container mode the policy stops only Fuli Provider and Neo4j
764
- containers; it does not shut down Rancher Desktop, Docker Desktop, Kubernetes, or the container VM
765
- itself. Native mode directly stops the corresponding Provider and Neo4j processes, so no shared VM
766
- overhead remains while idle.
767
-
768
- Jefa (project manager), Bole (AR, Agent Resources), and Tonborg (judgment) are built-in roles in every
769
- space and are never hired. Bole's workbench shows staffing, current work, and recruitment history;
770
- Tonborg's workbench shows decisions and feedback. Jefa's task board is built into FULI and needs no
771
- installation; **Manage assigned projects** on a role's card or workbench sets which projects it manages.
772
- The console has no hiring step: a custom employee package is recruited through the `recruit_employee` Agent
773
- tool, which reuses a durable identity with separate project assignments. An installed employee workbench and
774
- API share the FULI port; existing FULI MCP clients discover and call its tools. Recruitment does not start a
775
- model or rewrite client settings. See the [employee package and extension contract](docs/employee-agents.md).
776
- Agents can also grow small [Agent apps](docs/agent-apps.md); in this version an approved app runs
777
- unsandboxed with your account's permissions, after you confirm it with `fl app approve` in a terminal.
778
-
779
- Project Agent identities remain control-plane records rather than one resident process per identity.
780
- Roles now keep versioned, project-private working memory in the same Neo4j Provider. Task entry
781
- restores one owner across connected MCP clients; lifecycle checkpoints survive separate
782
- MCP processes. See [role memory, host hooks and acceptance boundaries](docs/project-agent-memory.md).
783
- Supported Codex and Claude Code hooks also journal visible conversations. Once unfolded messages pass
784
- a size threshold (64 KB by default), older ones fold into a digest; recovery stays within a byte budget. Specialist loans and artifact verification share the same Provider.
785
- See [conversation continuity and collaboration](docs/agent-conversations-and-collaboration.md)
786
- for client coverage, model capability configuration and acceptance limits.
787
- Physical executors share leases by executor ID. Fuli starts and stops only executors with an explicitly
788
- injected managed lifecycle adapter; host-owned external executors such as Codex are never started or
789
- killed implicitly. The current minimum-memory combination is:
790
-
791
- ```bash
792
- fuli setup --yes --runtime-mode native --memory-profile low --adaptive-memory
793
- ```
794
-
795
- The two modes use separate data directories. Switching preserves the old mode's data and never
796
- merges changes in the background. To migrate, export while the source mode is still active, then
797
- install or switch to the target mode and import:
130
+ `fuli setup` shows its plan and changes nothing until you confirm.
798
131
 
799
- ```bash
800
- # Rancher / Docker -> native
801
- fuli graph export --mode container --output "$HOME/Backups/fuli-container"
802
- fuli setup --yes --runtime-mode native --memory-profile low --adaptive-memory
803
- fuli graph import --target-mode native --input "$HOME/Backups/fuli-container" --yes
804
- ```
805
-
806
- Or run the same steps as one command, from a package that has the native runtime (on Windows the
807
- installed Fuli desktop package):
808
-
809
- ```bash
810
- fuli graph migrate --to native
811
- ```
812
-
813
- It stops the running console, counts and exports the container graph, sets up native mode, imports,
814
- and accepts the result only when every label and relationship-type count matches. On any failure it
815
- switches back to container mode. The container volume is only read and is left stopped, never removed.
816
- Client integrations are not changed.
132
+ ## The console
817
133
 
818
- Swap `container` and `native` for the reverse direction. Export briefly stops the source database
819
- and resumes only services that were actually running beforehand. Import validates the manifest and
820
- every dump's SHA-256 before stopping the target. It preserves the old target under `backups/graph`
821
- inside the data directory and attempts an immediate rollback if loading fails. Let active Agent graph
822
- writes finish before either operation.
134
+ <p align="center">
135
+ <img src="docs/readme/console-en.webp" alt="The FULI console: a task in review, a question waiting for you and the FLAs at work" width="800" />
136
+ </p>
823
137
 
824
- After loading, Fuli uses the target installation's bootstrap token to rotate local Provider access
825
- credentials and atomically updates the runtime configuration; plaintext access tokens are never added
826
- to the bundle. Unmanaged external Workspace connections are preserved for a same-device migration.
827
- Reconnect their credentials separately after moving the bundle to another device.
138
+ The console opens on what matters now: questions waiting for you, the FLAs at work and what they
139
+ finished. Everything runs on `127.0.0.1`; there is no account and no sign-in.
828
140
 
829
- The bundle is a directory containing `manifest.json`, `personal.dump`, and an optional
830
- `workspace.dump`; it can be copied to another disk or machine. Container mode transfers files through
831
- the Docker API, so the backup location does not need to be shared with Rancher. Dumps use the pinned
832
- Neo4j 5.26 format and are intended for the two Fuli runtime modes or a compatible Neo4j 5.26 setup;
833
- they are not a generic CSV/JSON interchange format for arbitrary databases.
141
+ ## FAQ
834
142
 
835
- Update:
143
+ <details>
144
+ <summary><b>Where is my data?</b></summary>
836
145
 
837
- ```bash
838
- fuli update
839
- ```
146
+ On your computer. Your personal graph and conversation records stay local. External knowledge
147
+ (Notion, Lark, MCP or RAG sources) is read-only: FULI never writes back.
148
+ </details>
840
149
 
841
- The update flow shows the running CLI, Node, PATH launchers, and npm installation target. If the
842
- current version is already latest, it exits without reinstalling or restarting services. Otherwise,
843
- it verifies that it will not downgrade, stops the old services, installs the latest version, and
844
- refreshes only clients with an existing Fuli MCP entry. Existing knowledge, configuration backups,
845
- and Neo4j volumes remain intact. Reuse any custom setup options during updates.
150
+ <details>
151
+ <summary><b>Which clients work with FULI?</b></summary>
846
152
 
847
- Reconnect Fuli in already-open clients, or restart those clients and open a new task, to load the
848
- new MCP process. To repair existing integrations that still have a Fuli MCP entry without upgrading,
849
- run `fuli setup --yes --connected-only`. Clients that are `skills-only`, `removed`, or newly added
850
- (no Fuli MCP entry) require a full `fuli setup`.
153
+ Claude Code, Codex, OpenCode, Cursor and Claude Desktop connect from the console with one click.
154
+ Other MCP clients run `fuli connect` for a standard configuration.
155
+ </details>
851
156
 
852
- Uninstall:
157
+ <details>
158
+ <summary><b>How do I call one of my FLAs?</b></summary>
853
159
 
854
- ```bash
855
- fuli uninstall
856
- npm uninstall --global fuli-context
857
- ```
160
+ Start a message with `#FLA` and its name. In Claude Code, OpenCode and Cursor you can also type
161
+ `/fla` and pick one from the menu; in the Codex app, type `/prompts:fla`. Turn the menu off in Settings › Clients.
162
+ </details>
858
163
 
859
- Automated uninstall does not permanently delete the personal graph, which allows a later install to
860
- reuse the same data.
164
+ <details>
165
+ <summary><b>How does FULI save tokens?</b></summary>
861
166
 
862
- ## Agent integrations and primary tools
167
+ A session starts with only the preferences in effect and a few related facts; the Agent looks up
168
+ the rest when it needs it. Facts that only you know, such as a sandbox URL you mentioned once,
169
+ come back later without a search through the code. The numbers are in the
170
+ [benchmark](FULI_ALIGNMENT_BENCHMARK.md) (section 8.9.4).
171
+ </details>
863
172
 
864
- Fuli installs the `capturing-session-knowledge`, `grilling-project`, `operating-fuli`, and `flreview` Skills for
865
- supported agents. `/flreview` asks FULI for ranked candidates, then the invoking Agent generates a
866
- fresh interactive review artifact. Codex rejects custom slash commands before any hook runs, so there the person
867
- types `fuli review` (or `flreview`) on its own line; the Codex prompt hook passes that exact line to the model with
868
- the installed Skill named, and in a session where FULI is off it answers the line itself without starting a review. FULI remains the durable source of truth and write surface; no
869
- permanent review tab or one-question-at-a-time chat flow is required.
870
- `operating-fuli` makes Agents inspect the structured interface-parity catalog before changing data,
871
- verify writes through matching read tools, and treat browser automation as visual verification only.
872
- See the [Agent interface architecture](docs/agent-interface-architecture.md).
873
- Fuli setup generates Claude Code `UserPromptSubmit`/`Stop` MCP hooks, a Codex
874
- `UserPromptSubmit` MCP hook plus a local `Stop` command, and Cursor
875
- `sessionStart`/`beforeSubmitPrompt`/`stop` hooks. The Codex Stop command first blocks an unfinished
876
- checkpoint; if the same token is still unfinished after one continuation, it records only
877
- `retain_nothing` to prevent an infinite loop and never invents knowledge or Agent memory. Codex
878
- bootstrap and Cursor instructions retain the fallback for tasks without supplied lifecycle context;
879
- they must not duplicate supplied preferences. Installing configuration never approves host trust.
880
- Preference content remains in local Fuli as the single source of truth and is not copied into agent
881
- configuration.
173
+ <details>
174
+ <summary><b>Do the built-in FLAs cost extra?</b></summary>
882
175
 
883
- FULI also exposes read-only `fuli://` resources for each local personal project and for global taste.
884
- Agents with MCP mention support can select them from the `@` picker; a project resource selects one
885
- exact project and never expands the search to other projects or `RELATED_TO` projects.
176
+ By default the built-in FLAs work inside your client's session. Only when you connect a model for
177
+ them do they use their own model, so nothing spends money behind your back.
178
+ </details>
886
179
 
887
- ### Remote Claude / Cowork connector upstream
180
+ <details>
181
+ <summary><b>How do I take FULI out of a client?</b></summary>
888
182
 
889
- `fuli remote-mcp` serves a least-privilege Streamable HTTP MCP endpoint bound to one exact personal
890
- project. It uses the distinct `claude` client attribution, requires an owner-only bearer-token file,
891
- rejects cross-origin requests, and listens on loopback only:
183
+ In the console, open Settings › Clients and choose Remove for that client. `fuli uninstall` and the
184
+ Windows uninstaller do the same for every connected client. FULI takes out only its own entries
185
+ (the MCP server, hooks, Skills and its permission lines), backs up each file first, and keeps a
186
+ Skill you edited yourself. Your FULI data stays until you delete it. On macOS, remove the clients
187
+ in the console before you move FULI.app to the Trash: the Trash alone leaves those entries in place.
188
+ </details>
892
189
 
893
- ```bash
894
- umask 077
895
- openssl rand -hex 32 > ./fuli-remote.token
896
- fuli remote-mcp --personal-project-id YOUR_PROJECT_ID \
897
- --bearer-token-file ./fuli-remote.token --port 2728
898
- ```
190
+ <details>
191
+ <summary><b>I installed FULI with npm before. Is it installed twice now?</b></summary>
899
192
 
900
- On POSIX systems the CLI opens the token nonblocking with no-follow semantics and requires mode
901
- `0600`. Windows does not provide the same `O_NOFOLLOW` or POSIX mode guarantees through Node.js, so
902
- the token must be a regular file in a directory protected by Windows ACLs and must not be a link.
193
+ The program is, your data is not: both use the same data folder. When the desktop client starts, it runs the one FULI
194
+ service and points your connected clients at itself. The console then offers to remove the npm copy with one click;
195
+ until it is removed, a bare `fl` in a terminal is still the npm version.
196
+ [Details](docs/install.md#already-installed-with-npm)
197
+ </details>
903
198
 
904
- Startup fails closed unless the project exists in the configured personal space. The upstream
905
- allows at most eight concurrent sessions and evicts sessions idle for 15 minutes; tune those bounds
906
- with `--max-sessions` and `--session-idle-ttl-seconds` when needed. Idle means no completed MCP
907
- application request: a silent standalone SSE notification stream does not pin a slot forever and
908
- may be closed at the TTL, after which the client must reconnect and initialize a new session.
909
- Shutdown gives bounded requests and session cleanup one shared grace deadline before forcing the
910
- remaining HTTP connections closed. When a reverse proxy supplies a
911
- browser Origin or preserves its public Host, add the exact values with
912
- `--allowed-origin https://connector.example --allowed-host connector.example`. Otherwise configure
913
- the proxy to rewrite Host to the loopback upstream authority. Arbitrary Origin and Host values are
914
- rejected. Each MCP session may read private context and memory only for the Agent selected by its
915
- task entry. A checkpoint token is also bound to both the upstream's configured project and the MCP
916
- session that created it, so neither another project process nor a peer session can reuse it.
199
+ <details>
200
+ <summary><b>Who decides what FULI keeps?</b></summary>
917
201
 
918
- This is an internal upstream, not a public deployment. Claude custom connectors originate from
919
- Anthropic's cloud and therefore require a public HTTPS endpoint with OAuth 2.1 in front of this
920
- listener. The proxy must validate user identity, token audience and scopes, then replace the external
921
- token with the internal bearer; never expose the Fuli Provider or Neo4j ports. Local lifecycle hooks
922
- do not run in claude.ai, so the MCP initialization instructions request task entry and checkpointing,
923
- but only a real connected Claude conversation can prove that behavior.
202
+ You do: AI looks things up and does the work, and humans retain final authority. Each task ends
203
+ with one check that keeps only reusable knowledge. A preference an Agent guessed counts once you,
204
+ or <img src="docs/readme/fla-tonborg-inline.webp" alt="" width="20" align="absmiddle" /> Tonborg within the autonomy you set, confirm it. Older answers stay in the history with their
205
+ source and reason.
206
+ </details>
924
207
 
925
- When a task needs a taste or judgment recommendation, `get_user_taste_skill` generates a bounded,
926
- read-only `user-taste` Skill projection from the effective personal profile and prior task data.
927
- The projection labels evidence status and scope, returns task-matched recommendations, and is
928
- regenerated as preferences are added or revised. It never overwrites a user-authored taste Skill;
929
- the durable graph remains the source of truth.
208
+ ## Learn more
930
209
 
931
- | Tool | Purpose |
210
+ | Topic | Read |
932
211
  | --- | --- |
933
- | `begin_task_context` | Hook entry: resolve the task, run bounded recall when signaled, and create a task token |
934
- | `get_collaboration_preferences` | Fallback entry: read effective preferences and bounded task recall |
935
- | `get_user_taste_skill` | Generate the current evidence-labeled taste Skill projection and task recommendations |
936
- | `search_current_project_knowledge` | Search the child first, then authorized knowledge sources |
937
- | `search_knowledge_graph` | Run a general query within an explicit bounded scope |
938
- | `search_connected_knowledge` | Search the graph, project-bound read-only sources, and selected public projects without merging provenance |
939
- | `record_knowledge_usage` | Record a citation or application that materially affected the result |
940
- | `record_knowledge_feedback` | Preserve rejection, failed validation, contradiction, or stale evidence |
941
- | `record_decision_trace` | Store options, rejected alternatives, rationale, and optional initial validation |
942
- | `capture_session_knowledge` | Store a small structured batch of durable candidates |
943
- | `checkpoint_task_knowledge` | Complete review with `capture_candidates` or `retain_nothing` |
944
- | `discover_common_knowledge_candidates` | Read-only discovery of possible parent-project knowledge |
945
- | `preview_common_knowledge_promotion` | Preview a human-confirmed promotion |
946
- | `apply_common_knowledge_promotion` | Apply the preview atomically with a one-time token |
947
- | `resolve_deferred_preference_conflict` | Resolve an AI-deferred conflict only when a task needs it |
948
- | `start_knowledge_review` | Start or resume an exact personal review scope |
949
- | `list_knowledge_review_candidates` | Rank candidates by time, conflicts, weight, and cross-session repetition |
950
- | `record_knowledge_review_progress` | Save keep, update, invalidate, skip, or defer outcomes |
951
- | `finish_knowledge_review` | Pause, or complete and advance the next-review watermark |
952
-
953
- ## Privacy and safety boundaries
954
-
955
- - Personal knowledge is written to the local Provider.
956
- - Agents distill structured knowledge separately from private, adapter-visible conversation journals.
957
- - Tokens, cookies, private keys, credentials, private contact details, temporary logs, and raw command
958
- output must not enter the graph.
959
- - Graphiti's remote-LLM path is disabled; embeddings are currently computed locally.
960
- - Searches are bounded by personal space and project scope instead of mixing every project.
961
- - External connectors never write to third-party sources; raw credentials are rejected from stored
962
- binding configuration.
963
- - Shared promotion requires auditable human confirmation. Agent usage evidence can promote an item
964
- only as far as `agent_confirmed`.
965
- - Fuli is not a real-time monitoring or Git service; current state must be read from the relevant
966
- source system.
967
-
968
- ## Local services
969
-
970
- | Service | Default loopback address | Availability |
971
- | --- | --- | --- |
972
- | Fuli management UI | `127.0.0.1:2727` | Always |
973
- | Personal Provider | `127.0.0.1:8787` | Always |
974
- | Personal Neo4j Browser / Bolt | `127.0.0.1:8060` / `127.0.0.1:7687` | Always |
975
- | Development shared Provider | `127.0.0.1:8788` | `--with-dev-public` only |
976
- | Development shared Neo4j Browser / Bolt | `127.0.0.1:7475` / `127.0.0.1:7688` | `--with-dev-public` only |
977
-
978
- These seven ports can be changed in Settings. Provider and Neo4j bindings remain loopback-only even
979
- when the management UI is started in LAN mode.
980
-
981
- To access the UI from another device on the same Wi-Fi, run `fuli start --lan`. Starting LAN mode
982
- from a loopback-only runtime safely restarts only the management UI and preserves Provider and
983
- graph data. Disable LAN in Settings and run `fuli restart`, or run `fuli restart --no-lan`, to return
984
- to loopback-only mode. Starting LAN mode again rotates the temporary access code.
985
-
986
- If a port is occupied, Docker Compose is unavailable, or the container runtime is not running,
987
- setup stops before modifying agent configuration and reports the cause.
988
-
989
- ## Acceptance and development
990
-
991
- - [Alignment Benchmark](FULI_ALIGNMENT_BENCHMARK.md)
992
- - [Chinese acceptance index](acceptance/README.md)
993
- - [Knowledge retrieval and confirmation diagrams](acceptance/知识检索与确认流程图.md)
994
- - [Read-only external-knowledge architecture](docs/external-knowledge-architecture.md)
995
-
996
- ```bash
997
- npm install
998
- npm test
999
- npm run test:package
1000
- npm run test:external-knowledge:live
1001
- ```
1002
-
1003
- The external-knowledge live test temporarily downloads two public official documentation
1004
- repositories, validates read-only synchronization and retrieval, then removes the complete
1005
- temporary directory. It is network-dependent and is not part of the default test suite.
1006
-
1007
- Provider validation:
1008
-
1009
- ```bash
1010
- python3.12 -m venv .venv
1011
- . .venv/bin/activate
1012
- python -m pip install "./graph-provider[dev]"
1013
- python -m compileall -q graph-provider/fuli_graph
1014
- python -m pytest -q graph-provider/tests
1015
- docker compose -f compose.graphiti.yml config --quiet
1016
- ```
1017
-
1018
- `npm run test:package` builds the web UI, creates a real npm tarball, installs it into an isolated
1019
- global prefix, and verifies `fuli` / `fl`, version output, help output, and the packaged UI. Tests,
1020
- QA screenshots, and internal design documents are excluded from the npm package.
1021
-
1022
- ## Brand
1023
-
1024
- <picture>
1025
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/lockup/fuli-lockup-bilingual-horizontal-dark.svg" />
1026
- <img src="https://raw.githubusercontent.com/JevonsCode/fuli/main/brand/svg/lockup/fuli-lockup-bilingual-horizontal.svg" alt="FULI 复利 lockup" width="280" />
1027
- </picture>
1028
-
1029
- The FULI mark, wordmarks and lockups come from the [FULI 复利 brand system on Figma](https://www.figma.com/community/file/1698659778015746085). See [`brand/README.md`](brand/README.md) for the brand files and how to change them.
1030
-
1031
- ## License
1032
-
1033
- [Apache-2.0](LICENSE)
212
+ | Install details, CLI commands, ports | [Install and run](docs/install.md) |
213
+ | Principles and what is stored where | [How FULI works](docs/how-it-works.md) |
214
+ | Connecting each client | [Connect a client](docs/client-connections.md) |
215
+ | Skills, hooks and MCP tools | [Agent integrations](docs/agent-tools.md) |
216
+ | Notion, Lark and other knowledge bases | [External knowledge](docs/external-knowledge.md) |
217
+ | <img src="docs/readme/fla-tonborg-inline.webp" alt="" width="20" align="absmiddle" /> Tonborg and autonomy | [Judgment and autonomy](docs/judgment-and-autonomy.md) |
218
+ | The roundtable | [Roundtable](docs/agent-roundtable.md) |
219
+ | What is proven so far | [Capabilities and limits](docs/capabilities-and-limits.md) · [Measured report](https://有点.意思.com/fuli/report/en/) |
220
+ | Running the source | [Develop and verify](docs/development.md) · [Contributing](CONTRIBUTING.md) |
221
+
222
+ The FULI mark and wordmarks come from the [FULI 复利 brand system](https://www.figma.com/community/file/1698659778015746085); see [`brand/README.md`](brand/README.md).
223
+ Licensed under [Apache-2.0](LICENSE).