fuli-context 0.23.0-beta.8 → 0.23.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 (505) hide show
  1. package/dist/web/assets/{AboutPage-BHbNacTY.js → AboutPage-S8QFfzpA.js} +1 -1
  2. package/dist/web/assets/AboutSectionHeading-B5CzH4Zs.js +1 -0
  3. package/dist/web/assets/AboutSectionHeading-DjXpIV27.css +1 -0
  4. package/dist/web/assets/AgentAppsPage-BYXraPFM.js +1 -0
  5. package/dist/web/assets/{AgentHand-BGzGOjzl.js → AgentHand-BGGdVdd9.js} +1 -1
  6. package/dist/web/assets/AgentManagement-Bza8k5ra.js +7 -0
  7. package/dist/web/assets/AgentManagement-CeF4mjtg.css +1 -0
  8. package/dist/web/assets/AgentMentionCopy-C72hY2QL.js +1 -0
  9. package/dist/web/assets/{AgentName-C5HzUHaA.js → AgentName-CUjBNQ8j.js} +1 -1
  10. package/dist/web/assets/AgentProfilePage-D5QUzw5N.css +1 -0
  11. package/dist/web/assets/AgentProfilePage-kp7-gRRx.js +5 -0
  12. package/dist/web/assets/AgentServicesPage-IsGaz7FY.js +1 -0
  13. package/dist/web/assets/{AppViewerPage-N5C_6WLz.css → AppViewerPage-CJ0Zy6LA.css} +1 -1
  14. package/dist/web/assets/AppViewerPage-CcOlwxck.js +1 -0
  15. package/dist/web/assets/{BackToTop-SL4ai3_g.js → BackToTop-C3KYEoCW.js} +1 -1
  16. package/dist/web/assets/BoardCardFieldsMenu-BlBWT1j7.js +1 -0
  17. package/dist/web/assets/BoardMoveMenu-Bc7xC1Uh.js +1 -0
  18. package/dist/web/assets/Breadcrumb-BbwBNrG2.css +1 -0
  19. package/dist/web/assets/Breadcrumb-C_xMiD-Z.js +1 -0
  20. package/dist/web/assets/CaptureChangePage-Bekp1aWg.js +1 -0
  21. package/dist/web/assets/ConnectionsPage-BpvecWXD.js +1 -0
  22. package/dist/web/assets/{CopyFixPrompt-CCrPxN5x.js → CopyFixPrompt-Bp-UX4Hq.js} +1 -1
  23. package/dist/web/assets/DataFormatPage-dsy8d3oA.js +2 -0
  24. package/dist/web/assets/DataFormatPage-sSnjjUY4.css +1 -0
  25. package/dist/web/assets/DebugTurnPage-HdFAyc2D.css +1 -0
  26. package/dist/web/assets/DebugTurnPage-cIJV7xDW.js +1 -0
  27. package/dist/web/assets/DebugTurnsPage-B6Te_Alp.js +1 -0
  28. package/dist/web/assets/DebugTurnsPage-BFuOzyWR.css +1 -0
  29. package/dist/web/assets/{DialogTitle-CTKjDGQc.js → DialogTitle-Lj5s6nwG.js} +1 -1
  30. package/dist/web/assets/EmployeeRedirectPage-DnvwJeCN.js +1 -0
  31. package/dist/web/assets/EmployeeScopeDialog-CXNZ62Ab.js +1 -0
  32. package/dist/web/assets/EmployeeWorkbench-BhReI8l6.css +1 -0
  33. package/dist/web/assets/EmployeeWorkbench-DALIO-cM.js +4 -0
  34. package/dist/web/assets/FieldRoot-DRnAC66O.js +1 -0
  35. package/dist/web/assets/FlaGrowth-7wlv31Tl.js +1 -0
  36. package/dist/web/assets/FlaGrowth-BzXY8pcx.css +1 -0
  37. package/dist/web/assets/FlaTaskSheets-CNdaBy1P.js +1 -0
  38. package/dist/web/assets/FlasPage-BCs1Ffpf.js +1 -0
  39. package/dist/web/assets/{FlasPage-Cb6Q5lge.css → FlasPage-SLQDMv47.css} +1 -1
  40. package/dist/web/assets/{button-CaCh3Iim.css → GrowthLoading-CigPij0N.css} +1 -1
  41. package/dist/web/assets/GrowthLoading-Cr8xZwwO.js +1 -0
  42. package/dist/web/assets/HowtoPage-Cv1YQy1s.js +1 -0
  43. package/dist/web/assets/{HowtoPage-BRV2W1Go.css → HowtoPage-t12tDDpS.css} +1 -1
  44. package/dist/web/assets/{InboxPage-DSOmt6VL.js → InboxPage-CgJnymOY.js} +2 -2
  45. package/dist/web/assets/KnowledgeDeleteButton-FEyEvhlR.js +1 -0
  46. package/dist/web/assets/KnowledgeHardDeleteSection-CVwTeMEJ.js +1 -0
  47. package/dist/web/assets/KnowledgeItemEditPage-rwpM8cF1.js +1 -0
  48. package/dist/web/assets/{KnowledgeItemSummaryCard-D1h0e1Hn.js → KnowledgeItemSummaryCard-49EADY_Z.js} +1 -1
  49. package/dist/web/assets/KnowledgeOrganizerPage-7IdnjM3L.js +1 -0
  50. package/dist/web/assets/KnowledgePage-gxqOIZxf.js +1 -0
  51. package/dist/web/assets/KnowledgePeek-Bm5jRVA9.css +1 -0
  52. package/dist/web/assets/KnowledgePeek-CQyCxHFj.js +1 -0
  53. package/dist/web/assets/KnowledgeTurnReceiptPage-BOz7IpaK.js +1 -0
  54. package/dist/web/assets/KnowledgeWorkspace-A7zVb26p.js +4 -0
  55. package/dist/web/assets/KnowledgeWorkspace-DCoVFyf0.css +1 -0
  56. package/dist/web/assets/{MeAvatar-DHJA3h2E.js → MeAvatar-CYVcRiuW.js} +1 -1
  57. package/dist/web/assets/{MeLink-CU7zuYgD.js → MeLink-BdqkzhT6.js} +1 -1
  58. package/dist/web/assets/{MenuSeparator-DV3U0Y8_.js → MenuSeparator-quqkZZXY.js} +1 -1
  59. package/dist/web/assets/ModelSettingsPage-B8jC_uew.js +3 -0
  60. package/dist/web/assets/ModelSettingsPage-DhCn_SF6.css +1 -0
  61. package/dist/web/assets/{NotFoundPage-BMWxdf6r.js → NotFoundPage-Dmn32VWo.js} +1 -1
  62. package/dist/web/assets/OccupationsPage-BVREfX_R.js +1 -0
  63. package/dist/web/assets/OverviewPage-CHyEbdP4.js +1 -0
  64. package/dist/web/assets/OverviewPage-xdF5g6bZ.css +1 -0
  65. package/dist/web/assets/{PageColumns-D7jIeVv6.js → PageColumns-DpfaPeu7.js} +1 -1
  66. package/dist/web/assets/PageOutline-BKBQ1T4d.js +1 -0
  67. package/dist/web/assets/PageOutline-BqVgnlos.css +1 -0
  68. package/dist/web/assets/PersonalProfilePage-Cxp2gn6J.js +1 -0
  69. package/dist/web/assets/PersonalProjectsPage-821imOxR.js +1 -0
  70. package/dist/web/assets/{PinIcon-DzYhXU_p.js → PinIcon-B7dvh7ld.js} +1 -1
  71. package/dist/web/assets/{PopperContent-BnejG-fO.js → PopperContent-DNqbLkNa.js} +1 -1
  72. package/dist/web/assets/{Presence-o9BoSyBV.js → Presence-D3HKb5Hb.js} +1 -1
  73. package/dist/web/assets/ProfileAuthorChip-7HSHODdR.js +1 -0
  74. package/dist/web/assets/ProfileAuthorChip-C_0hzDoP.css +1 -0
  75. package/dist/web/assets/ProjectAgentsPage-DBsXS6Xa.js +5 -0
  76. package/dist/web/assets/{ProjectAgentsPage-Dt37ogX1.css → ProjectAgentsPage-RpfiV2Fm.css} +1 -1
  77. package/dist/web/assets/ProjectJudgmentPolicy-GA33aSRi.js +2 -0
  78. package/dist/web/assets/PublicProjectsPage-PJlBI8IE.js +1 -0
  79. package/dist/web/assets/{RoundtablesPage-C6vo4kl6.css → RoundtablesPage-DK9A9J-y.css} +1 -1
  80. package/dist/web/assets/{RoundtablesPage-B2mqkwwR.js → RoundtablesPage-DT5DUXsa.js} +2 -2
  81. package/dist/web/assets/{RovingFocusGroup-CKxT5j44.js → RovingFocusGroup-BB0d3k17.js} +1 -1
  82. package/dist/web/assets/{RovingFocusItem-Cr-XrVve.js → RovingFocusItem-CFd7tXzD.js} +1 -1
  83. package/dist/web/assets/SessionMigrationPage-BZ1lEDQr.js +1 -0
  84. package/dist/web/assets/SessionRecordsPage-BMAAtIAt.js +1 -0
  85. package/dist/web/assets/SettingsPage-BYNEk6BM.js +1 -0
  86. package/dist/web/assets/SettingsPage-Uj1IpZpS.css +1 -0
  87. package/dist/web/assets/SharedJefaReportPage-g35o6jUb.js +1 -0
  88. package/dist/web/assets/TagVocabularyPage-COubNJXz.js +1 -0
  89. package/dist/web/assets/{TaskBlockerClear-38qdj0bl.js → TaskBlockerClear-B5MpHdlh.js} +1 -1
  90. package/dist/web/assets/{TaskBlockerNotice--X8TtCGj.js → TaskBlockerNotice-CIN0HRiE.js} +1 -1
  91. package/dist/web/assets/{TaskReason-COiuiZVd.js → TaskReason-LQ0CFiKu.js} +1 -1
  92. package/dist/web/assets/{TeamCard-Bl4riuQt.css → TeamCard-CsmWDw2Q.css} +1 -1
  93. package/dist/web/assets/TeamCard-D-kLa5rT.js +1 -0
  94. package/dist/web/assets/TeamCardsWidget-DGX9k0S6.js +1 -0
  95. package/dist/web/assets/{TeamIsland-D8ycFpkZ.js → TeamIsland-BIo-l49b.js} +2 -2
  96. package/dist/web/assets/{Teleport-BAIkXp2z.js → Teleport-C1upABpY.js} +1 -1
  97. package/dist/web/assets/{TextField-BFGv0VA5.js → TextField-ZnmRqG0h.js} +1 -1
  98. package/dist/web/assets/{UiChip-h_SUumBM.js → UiChip-CizeOu1Q.js} +1 -1
  99. package/dist/web/assets/UiDialog-CGTzxn3-.js +1 -0
  100. package/dist/web/assets/{UiDisclosure-BO5EAYyS.js → UiDisclosure-ueMA4jl0.js} +1 -1
  101. package/dist/web/assets/UiIcon-sD1hUsOF.js +1 -0
  102. package/dist/web/assets/{UiIconButton-C0WP-F-p.js → UiIconButton-CCo4NPYv.js} +1 -1
  103. package/dist/web/assets/{UiNotice-NCEwjNQR.js → UiNotice-DGPFbVo7.js} +1 -1
  104. package/dist/web/assets/{UiSegmented-B49yYjJ3.js → UiSegmented-BZ-jqnPE.js} +1 -1
  105. package/dist/web/assets/{UiWeight-DRIwuLUX.js → UiWeight-BRO3oVMZ.js} +1 -1
  106. package/dist/web/assets/{VirtualDirectoryList-Dieq64pn.js → VirtualDirectoryList-BkV3gj5E.js} +1 -1
  107. package/dist/web/assets/{VisuallyHidden-DIWFV5lV.js → VisuallyHidden-B8wfJ_mU.js} +1 -1
  108. package/dist/web/assets/{VisuallyHiddenInput-WxcAZDj2.js → VisuallyHiddenInput-Bdcr9CwC.js} +1 -1
  109. package/dist/web/assets/WidgetSlot-DFojQaSo.js +2 -0
  110. package/dist/web/assets/_plugin-vue_export-helper-B9AJmZbc.js +9 -0
  111. package/dist/web/assets/{agent-apps-CXhZLNMa.js → agent-apps-CKGFfySp.js} +1 -1
  112. package/dist/web/assets/{agent-avatar-xTnj6P4n.js → agent-avatar-V6M_DF3r.js} +1 -1
  113. package/dist/web/assets/agent-occupation-PZ2YAIM8.js +1 -0
  114. package/dist/web/assets/{agent-pins-CMBM9w6b.js → agent-pins-8KX0ynzy.js} +1 -1
  115. package/dist/web/assets/agent-profile-Clb-gYu-.css +1 -0
  116. package/dist/web/assets/{agent-roster-records-pCYzR1as.js → agent-roster-records-PfAgndHp.js} +1 -1
  117. package/dist/web/assets/{agent-workflows-IeF737kp.js → agent-workflows-DQlqVOoA.js} +1 -1
  118. package/dist/web/assets/{attach-closest-edge-B34lttZK.js → attach-closest-edge-D2qlayPy.js} +1 -1
  119. package/dist/web/assets/{attention-store-BTKBC8TZ.js → attention-store-BnZ8l3kk.js} +1 -1
  120. package/dist/web/assets/{badge-Bnc2nVhV.js → badge-DX_xrLV6.js} +1 -1
  121. package/dist/web/assets/button-CEkPBC1E.js +1 -0
  122. package/dist/web/assets/button-CoXXgtY5.css +1 -0
  123. package/dist/web/assets/{card-B2JIXyum.js → card-DNQ0_6vT.js} +1 -1
  124. package/dist/web/assets/{catalog-C8eUDXUx.js → catalog-KnpBkv5t.js} +1 -1
  125. package/dist/web/assets/{checkbox-Blw3CguI.js → checkbox-DPyLHneg.js} +1 -1
  126. package/dist/web/assets/{client-AaxCWoEF.js → client-CSQcWFRh.js} +2 -2
  127. package/dist/web/assets/client-connection-model-vO2cap6a.js +1 -0
  128. package/dist/web/assets/{client-links-store-CmP5Qsfa.js → client-links-store-DMqe0MbK.js} +1 -1
  129. package/dist/web/assets/combobox-zUq9bkyM.js +1 -0
  130. package/dist/web/assets/{console-DtxpKdVW.js → console-DaoAO-EO.js} +1 -1
  131. package/dist/web/assets/{context-menu-DSGaOBX2.js → context-menu-CcGDnF_k.js} +1 -1
  132. package/dist/web/assets/{conversation-launcher-settings-DAL9Kf4y.js → conversation-launcher-settings-CXFE-q_A.js} +1 -1
  133. package/dist/web/assets/{dialog-CwFuZvhM.js → dialog-CxhKMo0D.js} +1 -1
  134. package/dist/web/assets/dist-B9GqMC5C.js +1 -0
  135. package/dist/web/assets/dist-DIJqkL4O.js +1 -0
  136. package/dist/web/assets/dropdown-menu-CXmMnCBh.js +1 -0
  137. package/dist/web/assets/field-LNsBZqam.js +1 -0
  138. package/dist/web/assets/{format-bytes-N7zRFzUD.js → format-bytes-Bqefdt37.js} +1 -1
  139. package/dist/web/assets/{identity-BUFzZs1s.js → identity-DRfhWjty.js} +1 -1
  140. package/dist/web/assets/index-B4AMPpl_.css +1 -0
  141. package/dist/web/assets/index-BYIOAXnn.js +2 -0
  142. package/dist/web/assets/{input-Db1wVnd4.js → input-UoZ-0Xne.js} +1 -1
  143. package/dist/web/assets/{label--RjFNYxb.js → label-DpjbTOxt.js} +1 -1
  144. package/dist/web/assets/label-table-BnWNYfyk.js +1 -0
  145. package/dist/web/assets/{model-crzN3PVX.js → model-13BQndfF.js} +1 -1
  146. package/dist/web/assets/{model-KuA63FiT.js → model-B5g0CFcM.js} +1 -1
  147. package/dist/web/assets/model-BYKHVgJr.js +1 -0
  148. package/dist/web/assets/{model-B5f68kqL.js → model-CDevUwUw.js} +1 -1
  149. package/dist/web/assets/model-CpuIG8Du.js +4 -0
  150. package/dist/web/assets/{model-B5dQs6Zt.js → model-P5fSGsiJ.js} +1 -1
  151. package/dist/web/assets/{model-DOf6QDiY.js → model-pJ6k3zYD.js} +1 -1
  152. package/dist/web/assets/{motion-CeLn8y1x.js → motion-C-ZimCUS.js} +1 -1
  153. package/dist/web/assets/{motion-wEp9RlID.js → motion-QY5FKKko.js} +1 -1
  154. package/dist/web/assets/{motion-preference-DfUreaML.js → motion-preference-BQiiwhab.js} +1 -1
  155. package/dist/web/assets/{occupation-catalog-Crs_Zc8R.js → occupation-catalog-uDDhZwKK.js} +1 -1
  156. package/dist/web/assets/{option-DCSIgajR.js → option-CcHPBOo6.js} +1 -1
  157. package/dist/web/assets/{orchestration-filters-Cu9KEzWE.js → orchestration-filters-DmF4Qs8E.js} +1 -1
  158. package/dist/web/assets/{page-title-Bvm24KbY.js → page-title-NXphgeQI.js} +1 -1
  159. package/dist/web/assets/{person-profile-Cf0Sytyw.js → person-profile-DXXfpvta.js} +1 -1
  160. package/dist/web/assets/popover-xSRzcSmY.js +1 -0
  161. package/dist/web/assets/popup-host-Bmvrf-2t.js +1 -0
  162. package/dist/web/assets/{profile-model-DkDH6Qth.js → profile-model-6gTmScHC.js} +1 -1
  163. package/dist/web/assets/{project-board-layout-OeuzohUI.js → project-board-layout-DBQeP_QP.js} +1 -1
  164. package/dist/web/assets/{project-capture-BQAqeAJf.js → project-capture-BhYsDWwJ.js} +1 -1
  165. package/dist/web/assets/{project-origin-CENDtRuK.js → project-origin-D8jy8EF_.js} +1 -1
  166. package/dist/web/assets/{quick-edit-api-Qndjqk1h.js → quick-edit-api-WLh_88w6.js} +1 -1
  167. package/dist/web/assets/{radio-group-pfWejLFt.js → radio-group-B4r78nDh.js} +1 -1
  168. package/dist/web/assets/{role-names-aIXV-sMx.js → role-names-PECaMfQo.js} +1 -1
  169. package/dist/web/assets/{roundtable-live-D7Asm_GB.js → roundtable-live-DFeDF56c.js} +1 -1
  170. package/dist/web/assets/{runtime-dom.esm-bundler-BS2lpl87.js → runtime-dom.esm-bundler-f39i44Mt.js} +1 -1
  171. package/dist/web/assets/save-file-rPduHi2f.js +1 -0
  172. package/dist/web/assets/select-_JO3Mxdp.js +1 -0
  173. package/dist/web/assets/{session-launch-offers-kLW-dRsW.js → session-launch-offers-X9b0DwF1.js} +1 -1
  174. package/dist/web/assets/settings-restart-BnwcTv3i.js +1 -0
  175. package/dist/web/assets/shared-report-BxNVLalR.js +3 -0
  176. package/dist/web/assets/shared-report-mYIyRY9C.css +1 -0
  177. package/dist/web/assets/{source-adapters-CUxqZHz7.js → source-adapters-aupsL146.js} +1 -1
  178. package/dist/web/assets/{switch-Cdz4-JcE.js → switch-B3Y3oE_n.js} +1 -1
  179. package/dist/web/assets/{tabs-C3w1-eMu.js → tabs-BlcZiEMY.js} +1 -1
  180. package/dist/web/assets/{task-board-model-DSr4P56O.js → task-board-model-CmMKsWdY.js} +1 -1
  181. package/dist/web/assets/task-card-fields-DAx6zMLz.js +1 -0
  182. package/dist/web/assets/task-labels-BdDFvSAy.js +1 -0
  183. package/dist/web/assets/{task-reason-BywD_kfi.js → task-reason-7WnPreht.js} +1 -1
  184. package/dist/web/assets/{team-sheets-D8Y--CP4.js → team-sheets-Cr0ZTPw3.js} +1 -1
  185. package/dist/web/assets/{textarea-C228nxbD.js → textarea-CRzFqL9a.js} +1 -1
  186. package/dist/web/assets/{ui-BM8jZcP6.js → ui-BopQuQfc.js} +1 -1
  187. package/dist/web/assets/{useAgentRecords-D7x4xQ9O.js → useAgentRecords-CMtpd3Fj.js} +1 -1
  188. package/dist/web/assets/{useAgentWorkSummary-pc1i6nr0.js → useAgentWorkSummary-BQbhaHov.js} +1 -1
  189. package/dist/web/assets/{useApi-CROJJdhE-DZtkWJZv.js → useApi-CROJJdhE-CRCgNOqq.js} +1 -1
  190. package/dist/web/assets/{useClipboardCopy-sTthF_MD.js → useClipboardCopy-DkqKK3wY.js} +1 -1
  191. package/dist/web/assets/{useFocusReturn-BoyUh5y3.js → useFocusReturn-BZpVmQnM.js} +1 -1
  192. package/dist/web/assets/{useForwardExpose-CqXuqZvd.js → useForwardExpose-Di-MnbTz.js} +1 -1
  193. package/dist/web/assets/{useForwardPropsEmits-0F_e7unJ.js → useForwardPropsEmits-L9XcB5DG.js} +1 -1
  194. package/dist/web/assets/useForwardScopeId-CUQFIAIj.js +1 -0
  195. package/dist/web/assets/useKnowledgeItemPeek-PmQJixw5.js +1 -0
  196. package/dist/web/assets/{useMinimumLoadingDisplay-CzfqbQPs.js → useMinimumLoadingDisplay-CWPiOaDl.js} +1 -1
  197. package/dist/web/assets/useProjectAgentRoster-CWVpSsQ3.js +1 -0
  198. package/dist/web/assets/{useRoutePeek-BDgll9Fy.js → useRoutePeek-DxLVksbJ.js} +1 -1
  199. package/dist/web/assets/useTeamPeople-CDISP0PM.js +1 -0
  200. package/dist/web/assets/{useTeamWork-BSFi27vj.js → useTeamWork-BTZd_wKs.js} +1 -1
  201. package/dist/web/assets/{useTypeahead-D_g4j3Xp.js → useTypeahead-pEZNpBls.js} +1 -1
  202. package/dist/web/assets/{utils-C6vsxGrE.js → utils-B4pBTmyh.js} +1 -1
  203. package/dist/web/assets/utils-BsxOjD1Q.js +1 -0
  204. package/dist/web/assets/version-db3QWWjt.js +1 -0
  205. package/dist/web/assets/{vue-router-BPhQ0Qow.js → vue-router-B79HWW1l.js} +1 -1
  206. package/dist/web/assets/website-YgovUEcN.js +1 -0
  207. package/dist/web/index.html +71 -66
  208. package/docs/agent-interface-architecture.md +13 -4
  209. package/docs/client-connections.md +3 -2
  210. package/docs/employee-agents.md +11 -9
  211. package/docs/judgment-and-autonomy.md +4 -4
  212. package/graph-provider/fuli_graph/app.py +4 -0
  213. package/graph-provider/fuli_graph/collaboration_context.py +3 -7
  214. package/graph-provider/fuli_graph/graph_field_contract.py +10 -2
  215. package/graph-provider/fuli_graph/graph_format_builtin_occupations.py +33 -1
  216. package/graph-provider/fuli_graph/graph_format_migrations.py +18 -0
  217. package/graph-provider/fuli_graph/graph_query.py +3 -12
  218. package/graph-provider/fuli_graph/knowledge_index_scan.py +120 -0
  219. package/graph-provider/fuli_graph/knowledge_outdated.py +9 -1
  220. package/graph-provider/fuli_graph/knowledge_retrieval_models.py +95 -0
  221. package/graph-provider/fuli_graph/knowledge_retrieval_terms.py +116 -0
  222. package/graph-provider/fuli_graph/knowledge_search.py +220 -39
  223. package/graph-provider/fuli_graph/knowledge_semantic.py +87 -0
  224. package/graph-provider/fuli_graph/knowledge_semantic_index.py +98 -0
  225. package/graph-provider/fuli_graph/knowledge_semantic_models.py +72 -0
  226. package/graph-provider/fuli_graph/knowledge_semantic_query.py +19 -0
  227. package/graph-provider/fuli_graph/knowledge_versions.py +14 -7
  228. package/graph-provider/fuli_graph/models.py +4 -0
  229. package/graph-provider/fuli_graph/occupation_catalog.py +6 -3
  230. package/graph-provider/fuli_graph/personal_global_preferences.py +3 -7
  231. package/graph-provider/fuli_graph/preference_versions.py +110 -0
  232. package/graph-provider/fuli_graph/project_agent_models.py +3 -0
  233. package/graph-provider/fuli_graph/project_agent_recruitment_occupation.py +1 -1
  234. package/graph-provider/fuli_graph/provider_values.py +7 -0
  235. package/graph-provider/fuli_graph/search_projection.py +2 -6
  236. package/graph-provider/fuli_graph/store_knowledge.py +10 -1
  237. package/graph-provider/fuli_graph/task_context_routes.py +1 -1
  238. package/graph-provider/pyproject.toml +1 -1
  239. package/native/win32/fuli-win-helper.exe +0 -0
  240. package/npm-shrinkwrap.json +3 -4
  241. package/package.json +2 -1
  242. package/skills/capturing-session-knowledge/SKILL.md +14 -7
  243. package/skills/capturing-session-knowledge/references/capture.md +12 -2
  244. package/skills/capturing-session-knowledge/references/retrieval.md +13 -4
  245. package/skills/grilling-project/SKILL.md +2 -0
  246. package/skills/operating-fuli/SKILL.md +36 -8
  247. package/skills/operating-fuli/references/workflow-recipes.md +10 -9
  248. package/src/agent-apps/host-tools/catalog.js +3 -0
  249. package/src/agent-delegation/agent-tool.js +12 -2
  250. package/src/agent-delegation/delegation-header.js +32 -8
  251. package/src/agent-delegation/entry-prompts.js +54 -0
  252. package/src/agent-delegation/operation-log.js +17 -7
  253. package/src/agent-delegation/person-words.js +38 -0
  254. package/src/agent-delegation/port.js +6 -4
  255. package/src/agent-delegation/refusals.js +14 -0
  256. package/src/agent-kits/client-detection.js +7 -0
  257. package/src/agent-kits/client-installer.js +13 -0
  258. package/src/agent-tools/delegation-definitions.js +5 -3
  259. package/src/agent-tools/diagnostic-definitions.js +23 -0
  260. package/src/agent-tools/graph-definitions.js +4 -0
  261. package/src/agent-tools/graph-handlers.js +6 -1
  262. package/src/agent-tools/interface-catalog.js +47 -17
  263. package/src/agent-tools/model-backend-definitions.js +1 -1
  264. package/src/agent-tools/old-data-definitions.js +16 -0
  265. package/src/agent-tools/task-entry-definitions.js +1 -1
  266. package/src/agent-tools/work-surface-definitions.js +1 -1
  267. package/src/agents/claude-code/lifecycle-hook.js +19 -5
  268. package/src/agents/claude-code/transcript-format-probe.js +31 -0
  269. package/src/agents/codex/lifecycle-hook.js +27 -7
  270. package/src/agents/codex/transcript-format-probe.js +29 -0
  271. package/src/agents/cursor/lifecycle-hook.js +4 -1
  272. package/src/agents/lifecycle-failure.js +27 -0
  273. package/src/agents/lifecycle-message.js +10 -0
  274. package/src/agents/opencode/lifecycle-hook.js +18 -2
  275. package/src/agents/transcript-format-registry.js +34 -0
  276. package/src/agents/transcript-format-scan.js +71 -0
  277. package/src/cli/command-registry.js +3 -0
  278. package/src/cli/diagnostics-command.js +59 -0
  279. package/src/cli/setup-command.js +3 -0
  280. package/src/cli.js +5 -0
  281. package/src/conversations/entry-budget.js +1 -1
  282. package/src/conversations/entry-detail-readers.js +22 -0
  283. package/src/conversations/entry-inline-budget.js +24 -12
  284. package/src/conversations/entry-skeleton.js +27 -9
  285. package/src/conversations/preference-lifecycle.js +2 -1
  286. package/src/conversations/preference-session.js +5 -2
  287. package/src/conversations/preference-snapshot.js +4 -1
  288. package/src/conversations/preference-view.js +5 -1
  289. package/src/conversations/reply-citations.js +21 -0
  290. package/src/conversations/stop-auto-close.js +21 -9
  291. package/src/conversations/task-context-view.js +31 -0
  292. package/src/data-format/backup-retention.js +8 -0
  293. package/src/data-format/local-stores.js +24 -2
  294. package/src/debug-turns/fuli-surface.js +23 -0
  295. package/src/debug-turns/model-capture.js +84 -0
  296. package/src/debug-turns/model-request.js +97 -0
  297. package/src/debug-turns/record.js +178 -0
  298. package/src/debug-turns/recorder.js +53 -0
  299. package/src/debug-turns/store.js +91 -0
  300. package/src/debug-turns/transcript-reader.js +64 -0
  301. package/src/debug-turns/trigger.js +25 -0
  302. package/src/diagnostics/agent-tool.js +14 -0
  303. package/src/diagnostics/event-log.js +133 -0
  304. package/src/diagnostics/failure-records.js +43 -0
  305. package/src/diagnostics/query.js +114 -0
  306. package/src/diagnostics/safe-event.js +83 -0
  307. package/src/dreaming/run.js +310 -0
  308. package/src/dreaming/scheduler.js +58 -0
  309. package/src/employees/builtin/jefa/board-store.js +78 -19
  310. package/src/employees/builtin/jefa/http.js +8 -5
  311. package/src/employees/builtin/jefa/project-board.js +2 -0
  312. package/src/employees/builtin/jefa/tools.js +7 -6
  313. package/src/employees/recruitment.js +20 -2
  314. package/src/employees/service.js +11 -1
  315. package/src/graphiti/agent-growth.js +64 -0
  316. package/src/graphiti/collaboration-preference-projection.js +7 -0
  317. package/src/graphiti/collaboration-preference-workflow.js +3 -3
  318. package/src/graphiti/current-project-knowledge-search.js +24 -1
  319. package/src/graphiti/federated-application.js +19 -1
  320. package/src/graphiti/federated-search.js +8 -1
  321. package/src/graphiti/local-runtimes.js +13 -0
  322. package/src/graphiti/personal-projects.js +11 -0
  323. package/src/graphiti/project-agent-mapping.js +1 -0
  324. package/src/graphiti/project-agent-task-sheets.js +6 -2
  325. package/src/graphiti/project-agent-workflows.js +22 -4
  326. package/src/graphiti/project-profile-authors.js +14 -7
  327. package/src/graphiti/provider-client.js +36 -0
  328. package/src/graphiti/session-knowledge-migration.js +103 -3
  329. package/src/graphiti/session-migration-notices.js +65 -0
  330. package/src/graphiti/session-records.js +22 -4
  331. package/src/graphiti/task-context-entry.js +5 -1
  332. package/src/graphiti/task-entry-preferences.js +31 -2
  333. package/src/graphiti/task-entry-read-only.js +28 -0
  334. package/src/graphiti/task-knowledge-checkpoint.js +2 -0
  335. package/src/graphiti/task-knowledge-recall.js +96 -19
  336. package/src/graphiti/task-remember.js +7 -2
  337. package/src/graphiti/task-update-request.js +13 -0
  338. package/src/graphiti/temporary-project-scope.js +7 -1
  339. package/src/graphiti/turn-receipt-delivery.js +5 -3
  340. package/src/http/agent-delegation-gate.js +5 -4
  341. package/src/http/agent-growth-api-router.js +17 -0
  342. package/src/http/api-router.js +18 -2
  343. package/src/http/capture-onboarding-api-router.js +3 -2
  344. package/src/http/debug-turns-api-router.js +70 -0
  345. package/src/http/diagnostic-events-api-router.js +27 -0
  346. package/src/http/dreaming-api-router.js +32 -0
  347. package/src/http/graph-api-router.js +35 -1
  348. package/src/http/knowledge-item-api-router.js +19 -2
  349. package/src/http/knowledge-scope-api-router.js +3 -2
  350. package/src/http/old-data-api-router.js +47 -0
  351. package/src/http/person-profile-api-router.js +3 -2
  352. package/src/http/retrieval-terms-api-router.js +37 -0
  353. package/src/http/semantic-api-router.js +26 -0
  354. package/src/judgment/agent-view.js +1 -1
  355. package/src/judgment/backend.js +30 -0
  356. package/src/judgment/http.js +2 -1
  357. package/src/judgment/review-prompt.js +2 -0
  358. package/src/judgment/routing.js +10 -2
  359. package/src/judgment/service.js +8 -2
  360. package/src/judgment/store.js +17 -7
  361. package/src/local-runtime/lifecycle.js +3 -0
  362. package/src/local-runtime/windows-process-handle.js +9 -3
  363. package/src/mcp/create-mcp-server.js +42 -25
  364. package/src/mcp/process-registry.js +45 -3
  365. package/src/mcp/runtime.js +2 -1
  366. package/src/mcp/stdio-relay.js +4 -1
  367. package/src/mcp/tool-annotations.js +2 -0
  368. package/src/model-backends/adapters/anthropic-messages.js +1 -1
  369. package/src/model-backends/adapters/exchange.js +2 -2
  370. package/src/model-backends/adapters/openai-chat.js +1 -1
  371. package/src/model-backends/adapters/openai-embeddings.js +60 -0
  372. package/src/model-backends/adapters/registry.js +3 -1
  373. package/src/model-backends/adapters/typesafe-systemone.js +1 -1
  374. package/src/model-backends/budget.js +14 -8
  375. package/src/model-backends/config.js +49 -15
  376. package/src/model-backends/decision-contract.js +2 -1
  377. package/src/model-backends/http.js +19 -1
  378. package/src/model-backends/model-fetch.js +37 -0
  379. package/src/model-backends/port.js +165 -67
  380. package/src/model-backends/prompt.js +4 -3
  381. package/src/model-backends/request.js +42 -3
  382. package/src/native-runtime/runtime.js +28 -4
  383. package/src/old-data/agent-tools.js +17 -0
  384. package/src/old-data/backup-reader.js +78 -0
  385. package/src/old-data/console-actions.js +53 -0
  386. package/src/old-data/guarded-stores.js +18 -0
  387. package/src/old-data/inventory.js +142 -0
  388. package/src/old-data/port.js +53 -0
  389. package/src/person-profile/port.js +2 -1
  390. package/src/presence/windows-helper-pin.js +1 -1
  391. package/src/project-change-log/port.js +65 -0
  392. package/src/project-change-log/store.js +60 -0
  393. package/src/retrieval-terms/fill.js +102 -0
  394. package/src/retrieval-terms/runner.js +50 -0
  395. package/src/retrieval-terms/terms-model.js +99 -0
  396. package/src/security/sensitive-content.js +11 -0
  397. package/src/semantic/scheduler.js +50 -0
  398. package/src/semantic/semantic-index.js +94 -0
  399. package/src/server.js +20 -1
  400. package/src/setup/paths.js +1 -1
  401. package/src/setup/setup.js +7 -0
  402. package/src/system/client-connection-status.js +6 -4
  403. package/src/system/doctor-repair.js +16 -4
  404. package/src/system/doctor.js +75 -3
  405. package/src/system/log-paths.js +11 -0
  406. package/src/system/log-retention.js +2 -8
  407. package/src/system/mcp-process-scan.js +55 -0
  408. package/src/system/resource-monitor.js +18 -2
  409. package/src/system/system-service.js +39 -7
  410. package/src/system/windows-data-acl.js +109 -0
  411. package/src/work-surfaces/port.js +17 -11
  412. package/src/work-surfaces/sources.js +4 -3
  413. package/dist/web/assets/AboutSectionHeading-BOXKE5Le.js +0 -1
  414. package/dist/web/assets/AboutSectionHeading-CiD3M3eG.css +0 -1
  415. package/dist/web/assets/AgentAppsPage-DS2X485q.js +0 -1
  416. package/dist/web/assets/AgentConversations-D7QJVFIo.js +0 -2
  417. package/dist/web/assets/AgentConversations-oZFXZE1X.css +0 -1
  418. package/dist/web/assets/AgentMentionCopy-O6pAjjYE.js +0 -1
  419. package/dist/web/assets/AgentProfilePage-CKCTcTzc.js +0 -2
  420. package/dist/web/assets/AgentProfilePage-D1ha8O3z.css +0 -1
  421. package/dist/web/assets/AgentServicesPage-C3npKkHp.js +0 -1
  422. package/dist/web/assets/AgentWorkbench-CJ4TYQA1.css +0 -1
  423. package/dist/web/assets/AgentWorkbench-D9HGRW-n.js +0 -2
  424. package/dist/web/assets/AppViewerPage-Al4TzYJF.js +0 -1
  425. package/dist/web/assets/BoardMoveMenu-ncWgEitd.js +0 -1
  426. package/dist/web/assets/Breadcrumb-QzjzIJdS.js +0 -1
  427. package/dist/web/assets/Breadcrumb-bsc0JKtG.css +0 -1
  428. package/dist/web/assets/CaptureChangePage-BQdqH2qC.js +0 -1
  429. package/dist/web/assets/ConnectionsPage-Be8jIb93.js +0 -1
  430. package/dist/web/assets/DataFormatPage-0Ne27K6I.css +0 -1
  431. package/dist/web/assets/DataFormatPage-C92rwzHa.js +0 -2
  432. package/dist/web/assets/EmployeeScopeDialog-DdR2DzcW.js +0 -1
  433. package/dist/web/assets/EmployeeTaskBoard-Bo8JT36K.js +0 -3
  434. package/dist/web/assets/EmployeeTaskBoard-Dljjy_L7.css +0 -1
  435. package/dist/web/assets/EmployeeWorkbenchPage-B249Mgle.js +0 -3
  436. package/dist/web/assets/EmployeeWorkbenchPage-BBjZJ6Od.css +0 -1
  437. package/dist/web/assets/FieldRoot-YdKVCBhW.js +0 -1
  438. package/dist/web/assets/FlaTaskSheets-Cm5SLq7J.js +0 -1
  439. package/dist/web/assets/FlasPage-C57gTN5X.js +0 -1
  440. package/dist/web/assets/HowtoPage-CDJScY6b.js +0 -1
  441. package/dist/web/assets/KnowledgeDeleteButton-5EtCPPl4.js +0 -1
  442. package/dist/web/assets/KnowledgeHardDeleteSection-r0lZ7ijb.js +0 -1
  443. package/dist/web/assets/KnowledgeItemEditPage-BStIRllM.js +0 -1
  444. package/dist/web/assets/KnowledgeOrganizerPage-BByk8hbw.js +0 -1
  445. package/dist/web/assets/KnowledgePage-DuWS3bRP.js +0 -1
  446. package/dist/web/assets/KnowledgePeek-BycBJ2xR.js +0 -1
  447. package/dist/web/assets/KnowledgePeek-EvumfJER.css +0 -1
  448. package/dist/web/assets/KnowledgeTurnReceiptPage-DTcDN-pG.js +0 -1
  449. package/dist/web/assets/KnowledgeWorkspace-CJo-6xdn.js +0 -4
  450. package/dist/web/assets/KnowledgeWorkspace-DPBq-At0.css +0 -1
  451. package/dist/web/assets/ModelSettingsPage-C1ghraAh.js +0 -1
  452. package/dist/web/assets/ModelSettingsPage-ConWy_ec.css +0 -1
  453. package/dist/web/assets/OccupationsPage-BY1jej7i.js +0 -1
  454. package/dist/web/assets/OverviewPage-C7YJf-Cq.css +0 -1
  455. package/dist/web/assets/OverviewPage-Dl-H0EBe.js +0 -1
  456. package/dist/web/assets/PersonalProfilePage-BcaVzKM6.js +0 -1
  457. package/dist/web/assets/PersonalProjectsPage-CO4ZYVAI.js +0 -1
  458. package/dist/web/assets/ProjectAgentDetailPage-Bgh78Mr5.js +0 -8
  459. package/dist/web/assets/ProjectAgentDetailPage-h7hr9iee.css +0 -1
  460. package/dist/web/assets/ProjectAgentDialog--T6mU-FW.css +0 -1
  461. package/dist/web/assets/ProjectAgentDialog-DzTor5ky.js +0 -5
  462. package/dist/web/assets/ProjectAgentsPage-CzN183pa.js +0 -1
  463. package/dist/web/assets/ProjectJudgmentPolicy-BMlEBJM3.js +0 -2
  464. package/dist/web/assets/PublicProjectsPage-DAHT31B8.js +0 -1
  465. package/dist/web/assets/SessionMigrationPage-IW07XhmD.js +0 -1
  466. package/dist/web/assets/SessionRecordsPage-Du76tewc.js +0 -1
  467. package/dist/web/assets/SettingsPage-CJNXe313.js +0 -1
  468. package/dist/web/assets/SettingsPage-D3AYCNTC.css +0 -1
  469. package/dist/web/assets/SharedJefaReportPage-dzHSSGhu.js +0 -1
  470. package/dist/web/assets/TagVocabularyPage-C_oV6GFs.js +0 -1
  471. package/dist/web/assets/TeamCard-CdO0RiNB.js +0 -1
  472. package/dist/web/assets/TeamCardsWidget-Cg_kJmb-.js +0 -1
  473. package/dist/web/assets/UiDialog-CUgrU6SQ.js +0 -1
  474. package/dist/web/assets/UiIcon-DPv0eZIU.js +0 -1
  475. package/dist/web/assets/WidgetSlot-BSU_-l_4.js +0 -2
  476. package/dist/web/assets/_plugin-vue_export-helper-DQENg-QE.js +0 -9
  477. package/dist/web/assets/agent-occupation-BvOgDW-q.js +0 -1
  478. package/dist/web/assets/agent-profile-BBqkfac0.css +0 -1
  479. package/dist/web/assets/agent-task-board-Cf9il_1i.js +0 -1
  480. package/dist/web/assets/button-N4FjuQuJ.js +0 -1
  481. package/dist/web/assets/client-connection-model-C3gpYYl7.js +0 -1
  482. package/dist/web/assets/combobox-DHwWXUpj.js +0 -1
  483. package/dist/web/assets/desktop-client-DnfjyLBX.js +0 -1
  484. package/dist/web/assets/dist-BInsvNsv.js +0 -1
  485. package/dist/web/assets/dist-Dc8jFf8M.js +0 -1
  486. package/dist/web/assets/field-BQLn7Hfw.js +0 -1
  487. package/dist/web/assets/index-CXPYDcyq.js +0 -2
  488. package/dist/web/assets/index-x95VDmzK.css +0 -1
  489. package/dist/web/assets/judgment-api-CK9yqrpU.js +0 -1
  490. package/dist/web/assets/label-table-KdyaCTvK.js +0 -1
  491. package/dist/web/assets/model-D4kKYvpj.js +0 -1
  492. package/dist/web/assets/popover-D4YFkL_5.js +0 -1
  493. package/dist/web/assets/project-board-settings-DPP6xKLz.js +0 -1
  494. package/dist/web/assets/project-team-api-7ybLH-uJ.js +0 -1
  495. package/dist/web/assets/save-file-CRxAsski.js +0 -1
  496. package/dist/web/assets/select-CUy1AIwE.js +0 -1
  497. package/dist/web/assets/settings-restart-JYH81qB-.js +0 -1
  498. package/dist/web/assets/shared-report-8p3nBKr-.js +0 -1
  499. package/dist/web/assets/source-coverage-4PsHC9TK.js +0 -1
  500. package/dist/web/assets/task-labels-CXBG2chm.js +0 -1
  501. package/dist/web/assets/useForwardScopeId-DVUFcuwO.js +0 -1
  502. package/dist/web/assets/useKnowledgeItemPeek-KZveY8Wz.js +0 -1
  503. package/dist/web/assets/useTeamPeople-Dna3Yrm3.js +0 -1
  504. package/dist/web/assets/utils-BX1QI2N6.js +0 -1
  505. package/dist/web/assets/version-CBPeq5nI.js +0 -1
@@ -0,0 +1,19 @@
1
+ """What a search by meaning carries and answers (rec#88)."""
2
+ from typing import Annotated, Literal
3
+
4
+ from pydantic import Field
5
+
6
+ from .model_base import StrictModel
7
+
8
+ # How search found an item: by its words, by its meaning, or both.
9
+ SearchMatch = Literal['lexical', 'semantic', 'both']
10
+ SemanticVectorValues = Annotated[
11
+ list[Annotated[float, Field(allow_inf_nan=False)]], Field(min_length=1, max_length=8192)]
12
+
13
+
14
+ class SemanticQuery(StrictModel):
15
+ """The query's own meaning vector, computed by the model a person
16
+ connected. A model or length no stored vector has is no error: the
17
+ search then has no semantic part."""
18
+ model: str = Field(min_length=1, max_length=256)
19
+ vector: SemanticVectorValues
@@ -329,9 +329,11 @@ async def reasserted_entities(store, space, entity_ids, episode_id) -> dict[str,
329
329
  itself:
330
330
  - the head is current (an edit, a re-assertion): the mention lands there
331
331
  as ordinary evidence;
332
- - the head went out of date: the capture asserts it again and writes a new
333
- version (item_id) after head_id, with its episode as the new evidence; a
334
- replay of the same episode finds the same version."""
332
+ - the head went out of date or was invalidated: the capture asserts it
333
+ again and writes a new version (item_id) after head_id, with its episode
334
+ as the new evidence; a replay of the same episode finds the same version.
335
+ Landing on the ended head answered committed while the statement stayed
336
+ ended and unsearchable (rec#63); the ended head keeps its history."""
335
337
  records, _, _ = await store.runtime.driver.execute_query(
336
338
  '''
337
339
  UNWIND $item_ids AS id
@@ -359,8 +361,8 @@ async def _reassertion_landing(store, space, entity_id, episode_id) -> dict | No
359
361
  if record['replaced_by_item_id'] == version_id:
360
362
  return {'item_id': version_id, 'head_id': item_id}
361
363
  if not record['replaced_by_item_id']:
362
- out_of_date = bool(record['invalid_at']) and await _went_out_of_date(store, space, item_id)
363
- return {'item_id': version_id, 'head_id': item_id} if out_of_date else {'item_id': item_id}
364
+ restated = bool(record['invalid_at']) and await _ended_for_restatement(store, space, item_id)
365
+ return {'item_id': version_id, 'head_id': item_id} if restated else {'item_id': item_id}
364
366
  if record['replaced_by_item_kind'] not in (None, 'entity'):
365
367
  return {'item_id': item_id}
366
368
  item_id = record['replaced_by_item_id']
@@ -420,9 +422,14 @@ async def restated_relationships(store, space, relationship_ids) -> dict[str, st
420
422
  return renamed
421
423
 
422
424
 
423
- async def _went_out_of_date(store, space, item_id) -> bool:
425
+ async def _ended_for_restatement(store, space, item_id) -> bool:
426
+ """Whether a capture that states this ended entity again writes a new
427
+ version: it went out of date, or it was invalidated (as for relationships,
428
+ the same words said again are a new statement; only a person's restore takes
429
+ the invalidated version itself back)."""
424
430
  revisions = (await item_revisions(store, space, 'entity', [item_id])).get(item_id, [])
425
- return _END_OF_VALIDITY.get(ending_action(revisions)) in REASSERTABLE
431
+ action = ending_action(revisions)
432
+ return action == 'invalidate' or _END_OF_VALIDITY.get(action) in REASSERTABLE
426
433
 
427
434
 
428
435
  async def record_version_revision(store, actor, space, item_kind, item_id, *, revision_id, action, reason,
@@ -33,6 +33,7 @@ from .knowledge_audit_models import (
33
33
  PreferenceScopeChange,
34
34
  )
35
35
  from .model_base import StrictModel
36
+ from .knowledge_semantic_query import SearchMatch, SemanticQuery
36
37
  from .knowledge_weight_models import KnowledgeWeightView
37
38
  from .provider_values import json_object
38
39
  from .project_profile_authors import AuthoredField, ProjectFieldAuthor, default_field_authors
@@ -818,6 +819,7 @@ class SearchRequest(StrictModel):
818
819
  project_agent_id: str | None = Field(default=None, min_length=1, max_length=128)
819
820
  inherit_project_knowledge: bool = True
820
821
  include_personal_global: bool = False
822
+ semantic: SemanticQuery | None = None
821
823
 
822
824
  @field_validator('personal_project_ids')
823
825
  @classmethod
@@ -890,6 +892,7 @@ class EntitySearchResult(KnowledgeWeightView):
890
892
  scope_path: list[str] = Field(default_factory=list, max_length=9)
891
893
  source_uris: list[str] = Field(default_factory=list, max_length=20)
892
894
  score: float | None = None
895
+ matched_by: SearchMatch = 'lexical'
893
896
 
894
897
 
895
898
  class FactResult(KnowledgeWeightView):
@@ -941,6 +944,7 @@ class FactResult(KnowledgeWeightView):
941
944
  scope_path: list[str] = Field(default_factory=list, max_length=9)
942
945
  source_uris: list[str] = Field(default_factory=list, max_length=20)
943
946
  score: float | None = None
947
+ matched_by: SearchMatch = 'lexical'
944
948
 
945
949
 
946
950
  class SearchResult(StrictModel):
@@ -7,10 +7,11 @@ from .model_base import StrictModel
7
7
 
8
8
  # The occupation each fixed identity ships with: stored on the Agent when the
9
9
  # identity is created, read back from there, and never reassigned by a person
10
- # (occupation_locked). Bole is AR, so it holds Agent resources (graph/12).
10
+ # (occupation_locked). Bole is AR, so it holds Agent resources (graph/12);
11
+ # Jefa and Tonborg hold what they are called, not 管理 (graph/16).
11
12
  BUILTIN_AGENT_OCCUPATIONS = {
12
- 'employee.jefa': 'management', 'employee.bole': 'hr',
13
- 'employee.tonborg': 'management', 'employee.assistant': 'assistant',
13
+ 'employee.jefa': 'project_manager', 'employee.bole': 'hr',
14
+ 'employee.tonborg': 'decision_maker', 'employee.assistant': 'assistant',
14
15
  }
15
16
 
16
17
  _BUILTINS = [
@@ -25,6 +26,8 @@ _BUILTINS = [
25
26
  ('data', '数据', 'Data', '核验和分析数据并解释指标变化。', 'Validate and analyze data and explain metric changes.'),
26
27
  ('writing', '写作', 'Writing', '撰写和修改适合目标读者的内容。', 'Write and revise content for its intended audience.'),
27
28
  ('management', '管理', 'Management', '规划工作、协调资源并追踪项目进展。', 'Plan work, coordinate resources, and track project progress.'),
29
+ ('project_manager', '项目经理', 'Project manager', '拆解目标、维护看板与进展并为任务选择合适的 Agent。', 'Break down goals, maintain the board and progress, and choose the right Agent for each task.'),
30
+ ('decision_maker', '决策员', 'Decision maker', '依照用户偏好审核日常事项、给出建议并保留判断依据。', 'Review routine matters against user preferences, make recommendations, and keep the reasoning on record.'),
28
31
  ('frontend', '前端', 'Frontend', '实现和维护用户界面及浏览器端交互。', 'Build and maintain user interfaces and browser interactions.'),
29
32
  ('backend', '后端', 'Backend', '实现和维护服务接口、业务规则及存储。', 'Build and maintain service APIs, domain rules, and storage.'),
30
33
  ('mobile', '移动端', 'Mobile', '开发和维护移动应用及设备端体验。', 'Develop and maintain mobile applications and device experiences.'),
@@ -23,6 +23,7 @@ from .provider_values import (
23
23
  json_object,
24
24
  native_datetime,
25
25
  now_utc,
26
+ preference_key,
26
27
  preference_qualifiers,
27
28
  sha256_text,
28
29
  stable_uuid,
@@ -529,12 +530,7 @@ async def _candidate_source_snapshots(
529
530
  for record in records:
530
531
  value = dict(record)
531
532
  attributes = json_object(value.get('attributes_json'))
532
- preference_key = (
533
- attributes.get('preferenceKey')
534
- or attributes.get('preference_key')
535
- or value.get('key')
536
- or value.get('item_id')
537
- )
533
+ stated_key = preference_key(attributes, value.get('key'), value.get('item_id'))
538
534
  basis = json_object(value.get('confirmation_basis_json'))
539
535
  try:
540
536
  snapshot = PersonalGlobalPreferenceSourceSnapshot(
@@ -542,7 +538,7 @@ async def _candidate_source_snapshots(
542
538
  item_kind=value['item_kind'],
543
539
  project_id=value['project_id'],
544
540
  key=value.get('key') or value['item_id'],
545
- preference_key=preference_key,
541
+ preference_key=stated_key,
546
542
  preference_qualifiers=preference_qualifiers(attributes),
547
543
  title=value.get('title') or value['item_id'],
548
544
  instruction=value.get('instruction') or '',
@@ -0,0 +1,110 @@
1
+ """A corrected preference replaces the old one (rec#75).
2
+
3
+ A preference is known by its preference_key in one scope (global, one
4
+ project, or one project Agent). When a person confirms a preference, every
5
+ other current preference with the same key in the same scope ends where it
6
+ starts and links to it, the way a keyed value of a relation does
7
+ (knowledge_versions.end_keyed_values): it keeps its words and stays readable
8
+ as history. No model decides it, and nothing is deleted.
9
+
10
+ A confirmed capture that restates a stored preference under the same capture
11
+ key with new words is a new version of it: the capture writes it under a new
12
+ ID, so the stored version keeps its words instead of the capture silently
13
+ landing on it unchanged.
14
+ """
15
+ from .knowledge_versions import invalid_property, lock_knowledge, record_version_revision
16
+ from .provider_values import preference_key, stable_uuid
17
+
18
+ PREFERENCE_REPLACEMENT_REASON = 'A confirmed preference with the same key and scope replaced it.'
19
+
20
+
21
+ _FIELDS = '''
22
+ item.uuid AS item_id, item.fuli_key AS key, item.fuli_attributes_json AS attributes_json,
23
+ coalesce(item.fuli_preference_scope, 'global') AS preference_scope,
24
+ item.fuli_preference_project_id AS preference_project_id,
25
+ item.fuli_preference_agent_id AS preference_agent_id,
26
+ coalesce(item.fuli_confirmation_status, 'pending') AS confirmation_status
27
+ '''
28
+ _ENTITIES = ('''
29
+ MATCH (item:Entity {group_id: $group_id})
30
+ WHERE item.fuli_invalid_at IS NULL AND item.fuli_profile_aspect IS NOT NULL AND $where
31
+ RETURN 'entity' AS item_kind, item.name AS name, coalesce(item.summary, '') AS summary,''' + _FIELDS)
32
+ _RELATIONSHIPS = ('''
33
+ MATCH ()-[item:RELATES_TO {group_id: $group_id}]->()
34
+ WHERE item.invalid_at IS NULL AND item.fuli_profile_aspect IS NOT NULL AND $where
35
+ RETURN 'relationship' AS item_kind, item.name AS name, item.fact AS summary,''' + _FIELDS)
36
+ _SAME_SCOPE = ('''coalesce(item.fuli_preference_scope, 'global') = $scope
37
+ AND coalesce(item.fuli_preference_project_id, '') = coalesce($project_id, '')
38
+ AND coalesce(item.fuli_preference_agent_id, '') = coalesce($agent_id, '')''')
39
+
40
+
41
+ async def _preferences(store, space, query, **parameters) -> list[dict]:
42
+ records, _, _ = await store.runtime.driver.execute_query(
43
+ '// write-time supersession: current preferences\n' + query,
44
+ group_id=space['group_id'], routing_='r', **parameters)
45
+ return [{**dict(record), 'preference_key': preference_key(record['attributes_json'], record['key'],
46
+ record['item_id'])} for record in records]
47
+
48
+
49
+ def _named(item_kind) -> str:
50
+ return (_ENTITIES if item_kind == 'entity' else _RELATIONSHIPS).replace('$where', 'item.uuid IN $item_ids')
51
+
52
+
53
+ async def end_older_preferences(scoped, actor, space, item_kind, item_id, *, changed_by, created_at) -> list[dict]:
54
+ """Make the confirmed preference `item_id` the only current one of its key
55
+ and scope, inside the caller's transaction. Returns the items it ended."""
56
+ found = await _preferences(scoped, space, _named(item_kind), item_ids=[item_id])
57
+ if not found or found[0]['confirmation_status'] != 'confirmed':
58
+ return []
59
+ new = found[0]
60
+ await lock_knowledge(scoped, space)
61
+ same_scope = ' UNION ALL '.join(query.replace('$where', _SAME_SCOPE + ' AND item.uuid <> $item_id')
62
+ for query in (_ENTITIES, _RELATIONSHIPS))
63
+ ended = []
64
+ for old in await _preferences(scoped, space, same_scope, item_id=item_id, scope=new['preference_scope'],
65
+ project_id=new['preference_project_id'], agent_id=new['preference_agent_id']):
66
+ if old['preference_key'] == new['preference_key']:
67
+ old_kind = old['item_kind']
68
+ await _end(scoped, space, old_kind, old['item_id'], item_kind, item_id, created_at)
69
+ await record_version_revision(
70
+ scoped, actor, space, old_kind, old['item_id'],
71
+ revision_id=stable_uuid(space['id'], 'knowledge-revision', 'preference-replacement',
72
+ old['item_id'], item_id),
73
+ action='supersede', reason=PREFERENCE_REPLACEMENT_REASON,
74
+ previous={'content': old['summary'] or old['name'], 'invalidAt': None},
75
+ current={'content': old['summary'] or old['name'], 'invalidAt': created_at.isoformat(),
76
+ 'replacedByItemId': item_id, 'replacedByItemKind': item_kind,
77
+ 'preferenceReplacement': {'preferenceKey': new['preference_key']}},
78
+ changed_by=changed_by, created_at=created_at)
79
+ ended.append({'item_kind': old_kind, 'item_id': old['item_id']})
80
+ return ended
81
+
82
+
83
+ async def _end(scoped, space, item_kind, item_id, replaced_by_kind, replaced_by_id, created_at) -> None:
84
+ invalid = invalid_property(item_kind)
85
+ match = ('MATCH (item:Entity {uuid: $item_id, group_id: $group_id})' if item_kind == 'entity'
86
+ else 'MATCH ()-[item:RELATES_TO {uuid: $item_id, group_id: $group_id}]->()')
87
+ await scoped.runtime.driver.execute_query(
88
+ match + f'''
89
+ WHERE item.{invalid} IS NULL
90
+ SET item.fuli_ai_review_lock_version = coalesce(item.fuli_ai_review_lock_version, 0) + 1,
91
+ item.{invalid} = $created_at, item.expired_at = coalesce(item.expired_at, $created_at),
92
+ item.fuli_replaced_by_item_id = $replaced_by_id, item.fuli_replaced_by_item_kind = $replaced_by_kind
93
+ ''', item_id=item_id, group_id=space['group_id'], created_at=created_at,
94
+ replaced_by_id=replaced_by_id, replaced_by_kind=replaced_by_kind)
95
+
96
+
97
+ async def restated_preferences(store, space, entities, entity_ids, episode_id) -> dict[str, str]:
98
+ """For each confirmed preference the capture states under a stored
99
+ current preference's ID with other words, the new version's ID; the
100
+ settle step then ends the stored one (end_older_preferences). A replay of
101
+ the same episode finds the same ID."""
102
+ stated = {entity_id: entity for entity, entity_id in zip(entities, entity_ids, strict=True)
103
+ if entity.profile_aspect and entity.confirmation_status == 'confirmed'}
104
+ if not stated:
105
+ return {}
106
+ stored = await _preferences(store, space, _named('entity'), item_ids=list(stated))
107
+ return {record['item_id']: stable_uuid(space['id'], 'knowledge-version', 'entity', record['item_id'], episode_id)
108
+ for record in stored
109
+ if (stated[record['item_id']].name, stated[record['item_id']].summary)
110
+ != (record['name'], record['summary'])}
@@ -5,6 +5,7 @@ from pydantic import AliasChoices, Field, field_validator, model_validator
5
5
 
6
6
  from .model_validation import reject_credentials, validate_emoji_sequence
7
7
  from .models import SourceApplication, StrictModel
8
+ from .project_profile_authors import ProjectFieldAuthor
8
9
  from .project_agent_occupation_models import ProjectAgentOccupation, ProjectAgentOccupationInput
9
10
 
10
11
 
@@ -113,6 +114,8 @@ class ProjectAgentProfile(StrictModel):
113
114
  )
114
115
  responsibility: str = Field(min_length=1, max_length=4096)
115
116
  character: ProjectAgentCharacter = Field(default_factory=ProjectAgentCharacter)
117
+ # Who wrote each preference; the rules live in Node (project-profile-authors.js).
118
+ character_authors: dict[Literal['judgment', 'taste', 'personality'], ProjectFieldAuthor] = Field(default_factory=dict)
116
119
  expectations: str = Field(default='', max_length=4096)
117
120
  agent_type: ProjectAgentType = 'durable'
118
121
  work_kinds: list[str] = Field(default_factory=list, max_length=32)
@@ -22,7 +22,7 @@ def recruitment_occupation(request):
22
22
  'maintenance': 'engineering', 'code_review': 'engineering',
23
23
  'review': 'testing', 'verification': 'testing', 'test_validation': 'testing',
24
24
  'planning': 'management', 'project_context': 'lead',
25
- 'project_management': 'management', 'design': 'design',
25
+ 'project_management': 'project_manager', 'design': 'design',
26
26
  'research': 'research', 'writing': 'writing', 'data': 'data',
27
27
  'operations': 'operations', 'product': 'product',
28
28
  }
@@ -65,5 +65,12 @@ def preference_qualifiers(value) -> dict:
65
65
  }
66
66
 
67
67
 
68
+ def preference_key(attributes, key, item_id):
69
+ """The key a preference is known by: its stated preferenceKey, else the
70
+ capture key it was written with, else its ID."""
71
+ attributes = json_object(attributes)
72
+ return attributes.get('preferenceKey') or attributes.get('preference_key') or key or item_id
73
+
74
+
68
75
  def normalized_text(value) -> str:
69
76
  return ' '.join(str(value or '').strip().casefold().split())
@@ -10,6 +10,7 @@ from .knowledge_weight import effective_confirmation_status, knowledge_weight
10
10
  from .provider_values import (
11
11
  json_object,
12
12
  native_datetime as _native_datetime,
13
+ preference_key,
13
14
  preference_qualifiers,
14
15
  )
15
16
 
@@ -132,12 +133,7 @@ def fact_result(
132
133
  preference_project_id=metadata.get('preference_project_id'),
133
134
  preference_agent_id=metadata.get('preference_agent_id'),
134
135
  key=metadata.get('key'),
135
- preference_key=(
136
- attributes.get('preferenceKey')
137
- or attributes.get('preference_key')
138
- or metadata.get('key')
139
- or edge.uuid
140
- ),
136
+ preference_key=preference_key(attributes, metadata.get('key'), edge.uuid),
141
137
  preference_qualifiers=preference_qualifiers(attributes),
142
138
  defined_project_id=metadata.get('defined_project_id'),
143
139
  project_agent_id=metadata.get('project_agent_id'),
@@ -22,6 +22,7 @@ from .models import (
22
22
  StructuredEpisode,
23
23
  )
24
24
  from .personal_project_access import authorize_personal_project
25
+ from .preference_versions import restated_preferences
25
26
  from .project_agent_access import authorize_project_agent
26
27
  from .knowledge_versions import link_reasserted, lock_knowledge, reasserted_entities, restated_relationships
27
28
  from .provider_values import now_utc, stable_uuid
@@ -194,6 +195,12 @@ class StoreKnowledge:
194
195
  reasserted[entity_id]['item_id'] if entity_id in reasserted else entity_id
195
196
  for entity_id in entity_ids
196
197
  ]
198
+ # A confirmed preference stated again with other words is a new
199
+ # version; the stored one keeps its words and ends below (rec#75).
200
+ landed_ids = list(entity_ids)
201
+ restated_preference_ids = await restated_preferences(
202
+ self, space, episode.entities, landed_ids, episode_id)
203
+ entity_ids = [restated_preference_ids.get(entity_id, entity_id) for entity_id in entity_ids]
197
204
  entity_id_by_key = {
198
205
  entity.key: entity_id
199
206
  for entity, entity_id in zip(
@@ -301,7 +308,9 @@ class StoreKnowledge:
301
308
  raise HTTPException(status_code=409, detail={
302
309
  'code': 'versions_changed',
303
310
  'message': 'something this capture names ended meanwhile; retry the capture'})
304
- if reasserted != await reasserted_entities(scoped, space, captured_ids, episode_id):
311
+ if reasserted != await reasserted_entities(scoped, space, captured_ids, episode_id) or (
312
+ restated_preference_ids != await restated_preferences(
313
+ scoped, space, episode.entities, landed_ids, episode_id)):
305
314
  raise HTTPException(status_code=409, detail={
306
315
  'code': 'versions_changed',
307
316
  'message': 'a version this capture names changed meanwhile; retry the capture'})
@@ -16,7 +16,7 @@ def register_task_context_routes(application, store, Actor):
16
16
  personal_space_id: Annotated[str, Query(min_length=1, max_length=128)],
17
17
  project_agent_id: Annotated[str, Query(min_length=1, max_length=128)],
18
18
  personal_project_id: Annotated[str | None, Query(min_length=1, max_length=128)] = None,
19
- limit: Annotated[int, Query(ge=1, le=20)] = 5):
19
+ limit: Annotated[int, Query(ge=1, le=200)] = 5):
20
20
  return await store.recent_agent_sessions(
21
21
  actor, personal_space_id, project_agent_id, personal_project_id, limit,
22
22
  )
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "fuli-graph-provider"
3
- version = "0.23.0b8"
3
+ version = "0.23.0"
4
4
  description = "Graphiti-backed personal and shared project provider for Fuli."
5
5
  requires-python = ">=3.12"
6
6
  dependencies = [
Binary file
@@ -1,17 +1,18 @@
1
1
  {
2
2
  "name": "fuli-context",
3
- "version": "0.23.0-beta.8",
3
+ "version": "0.23.0",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "fuli-context",
9
- "version": "0.23.0-beta.8",
9
+ "version": "0.23.0",
10
10
  "license": "Apache-2.0",
11
11
  "dependencies": {
12
12
  "@a2a-js/sdk": "1.3.0",
13
13
  "@agentclientprotocol/sdk": "1.5.0",
14
14
  "@hono/node-server": "2.1.5",
15
+ "@internationalized/date": "3.12.4",
15
16
  "@modelcontextprotocol/sdk": "^1.31.0",
16
17
  "@peculiar/x509": "2.1.0",
17
18
  "reflect-metadata": "0.2.2",
@@ -613,7 +614,6 @@
613
614
  "version": "3.12.4",
614
615
  "resolved": "https://registry.npmjs.org/@internationalized/date/-/date-3.12.4.tgz",
615
616
  "integrity": "sha512-M1dEn4c1U1HsSlaVR8upZtSqvXrTkHDfv18H01uCSJyjVLDxnBR38v/fMxecmlwXKR4i9HeZcmgQAPE6A+aGJQ==",
616
- "dev": true,
617
617
  "license": "Apache-2.0",
618
618
  "dependencies": {
619
619
  "@swc/helpers": "^0.5.0"
@@ -1337,7 +1337,6 @@
1337
1337
  "version": "0.5.23",
1338
1338
  "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.23.tgz",
1339
1339
  "integrity": "sha512-5lSsMOTXURePglDfvuAQUqkGek9Hg2kksOYay2m0+XR++b2NWYL/4sWyuvVBIs8oKnJaxkdi9whaL/sqN13afw==",
1340
- "dev": true,
1341
1340
  "license": "Apache-2.0",
1342
1341
  "dependencies": {
1343
1342
  "tslib": "^2.8.0"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fuli-context",
3
- "version": "0.23.0-beta.8",
3
+ "version": "0.23.0",
4
4
  "description": "Local-first collaboration relationship graph for AI agents.",
5
5
  "type": "module",
6
6
  "files": [
@@ -90,6 +90,7 @@
90
90
  "@a2a-js/sdk": "1.3.0",
91
91
  "@agentclientprotocol/sdk": "1.5.0",
92
92
  "@hono/node-server": "2.1.5",
93
+ "@internationalized/date": "3.12.4",
93
94
  "@modelcontextprotocol/sdk": "^1.31.0",
94
95
  "@peculiar/x509": "2.1.0",
95
96
  "reflect-metadata": "0.2.2",
@@ -24,7 +24,8 @@ At the start of every user task, first use the lifecycle context supplied by the
24
24
  exists. A Claude Code `UserPromptSubmit` hook calls `begin_task_context`, which already loads
25
25
  collaboration preferences and resolves the exact local personal project from the current working
26
26
  directory. It also uses the submitted prompt transiently for bounded automatic project-memory
27
- recall and never stores or returns that prompt. Apply the returned `task_knowledge_recall` and
27
+ recall and never returns that prompt; it keeps it on this computer only so `run_delegated_action`
28
+ can check words relayed as the person's decision in the same turn, until the task checkpoints. Apply the returned `task_knowledge_recall` and
28
29
  preferences, then retain the opaque task token for any required checkpoint;
29
30
  do not redundantly call `get_collaboration_preferences`.
30
31
 
@@ -50,9 +51,11 @@ receipt; the next entry in the same native session auto-closes an eligible fallb
50
51
  `retain_nothing` / `reported`. Capture candidates, experiences, memory changes, explicit knowledge
51
52
  usage, collaborators, failures/blockers and meaningful work summaries still need an explicit
52
53
  checkpoint. Automatic closure never claims completed work or saved memory. An existing pending
53
- task is not proof that its Hook context reached this turn. If `task_lifecycle.status=not_started`,
54
+ task is not proof that its Hook context reached this turn. If `task_lifecycle.reason=data_format_read_only`, FULI waits for the person to confirm a data format update: use the preferences, keep reading and searching, skip the checkpoint, and tell the person once where to confirm. Otherwise, if `task_lifecycle.status=not_started`,
54
55
  preferences are available but checkpoint ownership is not established; report the missing
55
- host identity or prompt rather than reusing an earlier token. A blocked transcript handoff
56
+ host identity or prompt rather than reusing an earlier token. Such an entry lists working
57
+ memory, team and managers only as their `read` calls (`get_project_agent_memory`,
58
+ `get_project_team`, `list_employee_tools`); call one only when the task needs it. A blocked transcript handoff
56
59
  remains unverified even if the preference fallback and task-summary checkpoint succeed.
57
60
 
58
61
  ## Mandatory reply identity
@@ -86,10 +89,14 @@ Capture confirmed, stable information:
86
89
  - Personal: the user's enduring preferences, boundaries, habits, and working methods. Project-specific personal rules must explicitly link to that project instead of becoming global defaults.
87
90
  - Project: PRD facts, requirements, terminology, decisions, constraints, architecture, routes, APIs, metrics, and document-derived knowledge.
88
91
 
89
- For a runbook, decision, route, or other item likely to be recalled from shorthand, add a bounded
90
- `attributes.searchTerms` string array containing only neutral retrieval phrases supported by the
91
- item and observed task vocabulary. Search terms are retrieval metadata, not new factual claims;
92
- do not add speculative synonyms, credentials, or unrelated product names.
92
+ FULI search matches words, so you supply the meaning. For a runbook, decision, route, or other item
93
+ likely to be recalled later, add a bounded `attributes.searchTerms` string array with the other ways
94
+ someone would ask for it: synonyms, the task it serves, and the same idea in Chinese and English.
95
+ Search terms are retrieval metadata, not new factual claims; add no credentials and no unrelated
96
+ product names.
97
+
98
+ When a search finds nothing, try other words, then read `knowledge_index`: the project's titles, for
99
+ you to judge by meaning.
93
100
 
94
101
  Do not capture credentials, tokens, cookies, private keys, raw transcripts, temporary logs, command output, speculative conclusions, or disposable implementation details. Treat a correction as a replacement, not an additional conflicting fact.
95
102
 
@@ -70,7 +70,11 @@ personal global scope must use preference convergence, with an explicit target a
70
70
  into a public proposal.
71
71
  For a preference that may have both global and project-specific forms, store a stable
72
72
  `attributes.preferenceKey` on each form so the project value can explicitly override the same
73
- global decision without hiding unrelated preferences.
73
+ global decision without hiding unrelated preferences. Once a person confirms a preference whose
74
+ key matches a current one in the same scope (scope, project and Agent), FULI stores it as a new
75
+ version and ends the older one (history kept, nothing deleted; to go back, the person states the
76
+ old preference again). `search_current_project_knowledge` and `search_knowledge_graph` find an
77
+ entity preference by its key.
74
78
 
75
79
  Task entry injects these preferences by scene. When the user limits one to a kind of work, record
76
80
  it as `attributes.tasteDomain` (`frontend`, `ui`, `ux`, `design`, `visual`, `architecture`, `code`,
@@ -82,6 +86,11 @@ boundary and applies everywhere. Set `attributes.constraint` only when the user
82
86
  keeps a rule in every scene, `"soft"` lets small talk leave it out. The compact `remember` items
83
87
  take the same `constraint`, `workKind` and `tasteDomain` fields.
84
88
 
89
+ When the person asks to keep something for later ("remember", "keep this for later sessions",
90
+ "from now on", 记住, 以后都…), task entry adds `remember_guidance` and the task is never auto-closed:
91
+ record it with `checkpoint_task_knowledge` `remember` before finishing. Writing it into a repository
92
+ file or the host's own memory files does not put it in FULI.
93
+
85
94
  ## Route by Ownership
86
95
 
87
96
  - Route global personal knowledge to `targetKind: personal` without `personalProjectId`; it is written directly to the local personal graph.
@@ -135,8 +144,9 @@ Use `capture_session_knowledge` with a small, coherent batch:
135
144
  3. Create stable entity keys, typed entities, and explicit uppercase relationships. When relevant, model `GitCommit`, `CodeSymbol`, `PRDSection`, `Runbook`, and `Incident` entities and connect them with relationships such as `IMPLEMENTED_IN`, `DEFINED_BY`, `MOTIVATED_BY`, `APPLIES_TO`, and `INVESTIGATED_WITH`.
136
145
  4. Include source kind, source application, a non-sensitive source description, reference time, session ID, and a retry-safe idempotency key. When an online source was actually read, also include its exact stable `sourceUri`. When available, include a stable source turn ID and only the smallest relevant excerpt needed to understand the evidence; never include a full transcript.
137
146
  5. Use `supersedes` when replacing a known relationship and set confidence below `1` only when the source itself expresses uncertainty.
147
+ When the person says something kept changed ("moved", "instead of", "no longer", "correction", 改成, 不再), task entry adds `update_guidance` and the task is not auto-closed: find the current item with `search_current_project_knowledge` and revise it with `revise_personal_knowledge` (`action: update`). A delivered preference carries its `id` (and `item_kind` when it is not `entity`) for this; a task entry bounded to an inline limit leaves the IDs out, so search by its `preference_key`. Capture a new item only when none matches; a new one beside the old leaves both current.
138
148
  A value its subject has only one of (a URL, port, command, host, endpoint or owner) goes in one relationship from the subject whose type names it (`HAS_URL`, `RUNS_ON_PORT`, `START_COMMAND`, `OWNED_BY`); set `attributes.singleValued` to `true` for another single-valued relation, or `false` when such a type holds several. Once a person confirms a new value, FULI ends the older value of the same project, subject and relation itself (history kept; the person can restore it), so do not mark it outdated as well. Until then the older value stays current and waits for the person.
139
- A capture result's `possibly_outdated` lists older items the new knowledge may silently replace (a pending keyed value, or a note of the same type in the same project that mostly repeats it). They stay current and wait for the person's review; `superseded` lists keyed values a confirmed one ended. Neither is a write of yours to repeat or undo.
149
+ A capture result's `possibly_outdated` lists older items the new knowledge may silently replace (a pending keyed value, or a note of the same type in the same project that mostly repeats it). They stay current and wait for the person's review; `superseded` lists keyed values and same-key preferences a confirmed one ended. Neither is a write of yours to repeat or undo.
140
150
  When an item is concluded from current knowledge (a project fact drawn from a preference), list those item IDs in `derivedFrom`; once one of them is marked outdated the conclusion is no longer delivered as a current fact.
141
151
  6. Flush silently at the boundary. Continue the user's task without narrating routine capture.
142
152
 
@@ -29,10 +29,12 @@ personal preferences. Do not search for a fully self-contained task or use Fuli
29
29
  external state.
30
30
 
31
31
  First inspect `task_knowledge_recall` returned by the lifecycle or preference tool. Its automatic
32
- query plan is deliberately bounded and based on implementation trigger categories, not on a
33
- claim that every returned candidate supports the task. If it misses or its candidates are
34
- irrelevant while durable context may still matter, call `search_current_project_knowledge`
35
- yourself. A coding task without such a trigger may instead get `status: indexed` with a
32
+ query plan is deliberately bounded: trigger categories (including a named convention, owner or
33
+ "the way we" do something) plus short queries from the prompt's own clauses, not on a claim that
34
+ every returned candidate supports the task. A `no_match` recall is one quick search, and says so in
35
+ `next`: before taking a project value or rule (port, command, owner, convention) from repository
36
+ files, which may be out of date, call `search_current_project_knowledge` for it yourself. Do the same
37
+ whenever its candidates are irrelevant while durable context may still matter. A coding task without such a trigger may instead get `status: indexed` with a
36
38
  `knowledge_index`: up to five `[id, title]` pairs of matching items in the exact current project and
37
39
  `matched_in_search`, how many items that one bounded search kept, never their bodies. It is not the
38
40
  project's total: more may match a search of your own. A title is only a pointer: read the item with
@@ -122,6 +124,13 @@ promote only to `agent_confirmed`; it never substitutes for human confirmation o
122
124
  eligible for public publication. Use the current user task's caller-stable identifier as
123
125
  `taskId` and reuse it on retries; never generate another ID to recount the same task.
124
126
 
127
+ A task the Stop hook closes needs no report: a FULI source link in your final reply is recorded as `cited` for that item, so keep `sourceMarker` links exact. Only cite what supported the answer.
128
+
129
+ This is also how an FLA grows: a reusable experience it reported counts only when a later task
130
+ records applying it. Experiences used across several tasks appear on the FLA's page (「学会了」),
131
+ where the person keeps or drops each; never confirm or drop your own experiences instead. When the
132
+ person corrects your approach, report the corrected approach as an experience with its `boundary`.
133
+
125
134
  ## Use the Generated Taste Skill
126
135
 
127
136
  When a UI, writing, product, architecture, code, or other judgment call would benefit from the
@@ -70,6 +70,8 @@ Before updating an existing project, call `list_personal_projects` with its exac
70
70
 
71
71
  Each of `purpose`, `scope`, `technicalSummary` and `boundaries` carries its author in `profile.authors`: `person` (the user wrote it, weight 100%, authoritative), `both` (the user edited an Agent's draft, 90%) or `agent` (an AI draft, 50%, editable). Fill empty or `agent` fields freely. Never overwrite a `person` or `both` field: FULI keeps it and lists it in `refused_fields`; tell the user what you would change and let them edit it in the console. When you report the profile, say which fields the user wrote and which are your drafts.
72
72
 
73
+ FULI records each real change to the profile's name, lifecycle, sources and the authored fields in the project's 修改记录, under the writer's Agent name and with the before and after text. A save that changes nothing and a field you were refused add nothing, and the record cannot be edited. The console shows it with the project's creation date on the overview; there is no Agent tool for it, so read the current profile as usual.
74
+
73
75
  ## Evidence coverage assessment
74
76
 
75
77
  Recompute the assessment when evidence changes. Follow the dimensions and scoring guidance in the reference.