@rpamis/comet 0.4.0-rc.3 → 0.4.0-rc.5

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 (296) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +1 -0
  3. package/assets/manifest.json +1 -1
  4. package/assets/skills/comet/scripts/comet-archive.mjs +2 -2
  5. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +56 -56
  6. package/assets/skills/comet/scripts/comet-guard.mjs +51 -51
  7. package/assets/skills/comet/scripts/comet-handoff.mjs +29 -29
  8. package/assets/skills/comet/scripts/comet-hook-guard.mjs +35 -35
  9. package/assets/skills/comet/scripts/comet-hook-router.mjs +162 -156
  10. package/assets/skills/comet/scripts/comet-resume-probe.mjs +34 -34
  11. package/assets/skills/comet/scripts/comet-runtime.mjs +69 -69
  12. package/assets/skills/comet/scripts/comet-state.mjs +38 -38
  13. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +20 -20
  14. package/assets/skills/comet-native/SKILL.md +6 -7
  15. package/assets/skills/comet-native/reference/artifacts.md +1 -2
  16. package/assets/skills/comet-native/reference/clarification.md +6 -6
  17. package/assets/skills/comet-native/reference/commands.md +2 -0
  18. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +127 -126
  19. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +136 -135
  20. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +61 -60
  21. package/assets/skills/comet-native/scripts/comet-native-init.mjs +30 -29
  22. package/assets/skills/comet-native/scripts/comet-native-new.mjs +125 -124
  23. package/assets/skills/comet-native/scripts/comet-native-next.mjs +123 -122
  24. package/assets/skills/comet-native/scripts/comet-native-root.mjs +16 -15
  25. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +165 -164
  26. package/assets/skills/comet-native/scripts/comet-native-select.mjs +111 -110
  27. package/assets/skills/comet-native/scripts/comet-native-show.mjs +81 -80
  28. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +118 -117
  29. package/assets/skills/comet-native/scripts/comet-native-status.mjs +108 -107
  30. package/assets/skills-zh/comet-native/SKILL.md +6 -7
  31. package/assets/skills-zh/comet-native/reference/artifacts.md +1 -2
  32. package/assets/skills-zh/comet-native/reference/clarification.md +6 -6
  33. package/assets/skills-zh/comet-native/reference/commands.md +2 -0
  34. package/dist/app/cli/index.js +16 -0
  35. package/dist/app/cli/index.js.map +1 -1
  36. package/dist/app/commands/comet-task.d.ts +3 -0
  37. package/dist/app/commands/comet-task.d.ts.map +1 -1
  38. package/dist/app/commands/comet-task.js +21 -0
  39. package/dist/app/commands/comet-task.js.map +1 -1
  40. package/dist/app/commands/native.js +2 -0
  41. package/dist/app/commands/native.js.map +1 -1
  42. package/dist/app/commands/personal-memory.d.ts.map +1 -1
  43. package/dist/app/commands/personal-memory.js +1 -0
  44. package/dist/app/commands/personal-memory.js.map +1 -1
  45. package/dist/app/commands/project-knowledge.d.ts +3 -0
  46. package/dist/app/commands/project-knowledge.d.ts.map +1 -1
  47. package/dist/app/commands/project-knowledge.js +39 -1
  48. package/dist/app/commands/project-knowledge.js.map +1 -1
  49. package/dist/domains/agent-learning/context-director.d.ts +14 -5
  50. package/dist/domains/agent-learning/context-director.d.ts.map +1 -1
  51. package/dist/domains/agent-learning/context-director.js +106 -26
  52. package/dist/domains/agent-learning/context-director.js.map +1 -1
  53. package/dist/domains/comet-entry/plugin-context.d.ts +2 -1
  54. package/dist/domains/comet-entry/plugin-context.d.ts.map +1 -1
  55. package/dist/domains/comet-entry/plugin-context.js +10 -1
  56. package/dist/domains/comet-entry/plugin-context.js.map +1 -1
  57. package/dist/domains/comet-memory/personal-memory.d.ts.map +1 -1
  58. package/dist/domains/comet-memory/personal-memory.js +126 -33
  59. package/dist/domains/comet-memory/personal-memory.js.map +1 -1
  60. package/dist/domains/comet-memory/plugin.js +3 -1
  61. package/dist/domains/comet-memory/plugin.js.map +1 -1
  62. package/dist/domains/comet-memory/types.d.ts +7 -0
  63. package/dist/domains/comet-memory/types.d.ts.map +1 -1
  64. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  65. package/dist/domains/comet-native/native-archive-command.js +119 -19
  66. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  67. package/dist/domains/comet-native/native-artifacts.d.ts +1 -0
  68. package/dist/domains/comet-native/native-artifacts.d.ts.map +1 -1
  69. package/dist/domains/comet-native/native-artifacts.js +53 -2
  70. package/dist/domains/comet-native/native-artifacts.js.map +1 -1
  71. package/dist/domains/comet-native/native-children.d.ts +1 -0
  72. package/dist/domains/comet-native/native-children.d.ts.map +1 -1
  73. package/dist/domains/comet-native/native-children.js +1 -0
  74. package/dist/domains/comet-native/native-children.js.map +1 -1
  75. package/dist/domains/comet-native/native-cli-help.js +6 -6
  76. package/dist/domains/comet-native/native-cli-help.js.map +1 -1
  77. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -1
  78. package/dist/domains/comet-native/native-doctor-command.js +41 -1
  79. package/dist/domains/comet-native/native-doctor-command.js.map +1 -1
  80. package/dist/domains/comet-native/native-experience.d.ts.map +1 -1
  81. package/dist/domains/comet-native/native-experience.js +23 -10
  82. package/dist/domains/comet-native/native-experience.js.map +1 -1
  83. package/dist/domains/comet-native/native-loop-runtime.d.ts +4 -0
  84. package/dist/domains/comet-native/native-loop-runtime.d.ts.map +1 -1
  85. package/dist/domains/comet-native/native-loop-runtime.js +29 -2
  86. package/dist/domains/comet-native/native-loop-runtime.js.map +1 -1
  87. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  88. package/dist/domains/comet-native/native-next-command.js +42 -18
  89. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  90. package/dist/domains/comet-native/native-portable-continuation.d.ts +11 -4
  91. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -1
  92. package/dist/domains/comet-native/native-portable-continuation.js +173 -15
  93. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -1
  94. package/dist/domains/comet-native/native-portable-recovery.d.ts +1 -1
  95. package/dist/domains/comet-native/native-portable-recovery.d.ts.map +1 -1
  96. package/dist/domains/comet-native/native-portable-recovery.js +26 -1
  97. package/dist/domains/comet-native/native-portable-recovery.js.map +1 -1
  98. package/dist/domains/comet-native/native-portable-runtime.d.ts +7 -1
  99. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -1
  100. package/dist/domains/comet-native/native-portable-runtime.js +163 -11
  101. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -1
  102. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -1
  103. package/dist/domains/comet-native/native-portable-state.js +6 -0
  104. package/dist/domains/comet-native/native-portable-state.js.map +1 -1
  105. package/dist/domains/comet-native/native-portable-status.d.ts +5 -0
  106. package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -1
  107. package/dist/domains/comet-native/native-portable-status.js +21 -1
  108. package/dist/domains/comet-native/native-portable-status.js.map +1 -1
  109. package/dist/domains/comet-native/native-portable-summary.d.ts +7 -1
  110. package/dist/domains/comet-native/native-portable-summary.d.ts.map +1 -1
  111. package/dist/domains/comet-native/native-portable-summary.js +20 -1
  112. package/dist/domains/comet-native/native-portable-summary.js.map +1 -1
  113. package/dist/domains/comet-native/native-portable-types.d.ts +1 -0
  114. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -1
  115. package/dist/domains/comet-native/native-portable-types.js.map +1 -1
  116. package/dist/domains/comet-native/native-runner-input.d.ts.map +1 -1
  117. package/dist/domains/comet-native/native-runner-input.js +12 -4
  118. package/dist/domains/comet-native/native-runner-input.js.map +1 -1
  119. package/dist/domains/comet-native/native-supervisor-overlay.d.ts +30 -0
  120. package/dist/domains/comet-native/native-supervisor-overlay.d.ts.map +1 -0
  121. package/dist/domains/comet-native/native-supervisor-overlay.js +202 -0
  122. package/dist/domains/comet-native/native-supervisor-overlay.js.map +1 -0
  123. package/dist/domains/comet-native/native-supervisor.d.ts.map +1 -1
  124. package/dist/domains/comet-native/native-supervisor.js +7 -3
  125. package/dist/domains/comet-native/native-supervisor.js.map +1 -1
  126. package/dist/domains/comet-native/native-types.d.ts +1 -0
  127. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  128. package/dist/domains/comet-native/native-workspace-finish.d.ts +12 -1
  129. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -1
  130. package/dist/domains/comet-native/native-workspace-finish.js +77 -22
  131. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -1
  132. package/dist/domains/comet-plugin/integration.d.ts +2 -2
  133. package/dist/domains/comet-plugin/integration.d.ts.map +1 -1
  134. package/dist/domains/comet-plugin/integration.js +22 -4
  135. package/dist/domains/comet-plugin/integration.js.map +1 -1
  136. package/dist/domains/dashboard/web/assets/{abnfDiagram-VCTEODGH-UcCx24DV.js → abnfDiagram-VCTEODGH-DktP_xx6.js} +1 -1
  137. package/dist/domains/dashboard/web/assets/{arc-n8qsRq7W.js → arc-Bn1VKVxB.js} +1 -1
  138. package/dist/domains/dashboard/web/assets/architecture-7GRP2DOG-Doz1cLoT.js +1 -0
  139. package/dist/domains/dashboard/web/assets/{architectureDiagram-5GKGNRK7-D4pJ8CU0.js → architectureDiagram-5GKGNRK7-B968UcrU.js} +1 -1
  140. package/dist/domains/dashboard/web/assets/{blockDiagram-I7D4REHJ-C7n-qrSQ.js → blockDiagram-I7D4REHJ-Ben_8wAV.js} +1 -1
  141. package/dist/domains/dashboard/web/assets/{c4Diagram-7LVT6UL2-cMVrWYOm.js → c4Diagram-7LVT6UL2-Dob7HfzV.js} +1 -1
  142. package/dist/domains/dashboard/web/assets/channel-CVf4X4BV.js +1 -0
  143. package/dist/domains/dashboard/web/assets/{chunk-4HAMMTFA-CE5QrCQd.js → chunk-4HAMMTFA-WLtkq7Gw.js} +1 -1
  144. package/dist/domains/dashboard/web/assets/{chunk-75Z2AOVW-BtZqN-pM.js → chunk-75Z2AOVW-DPRWDP1s.js} +1 -1
  145. package/dist/domains/dashboard/web/assets/{chunk-DU6HZSFF-CChv0huc.js → chunk-DU6HZSFF-B4Z8Mce9.js} +1 -1
  146. package/dist/domains/dashboard/web/assets/{chunk-F27PBJKO-CDT1ttJ8.js → chunk-F27PBJKO-D5FH4UPb.js} +1 -1
  147. package/dist/domains/dashboard/web/assets/{chunk-GMAD6QVW-y5m6LMR7.js → chunk-GMAD6QVW-D0gALUpa.js} +1 -1
  148. package/dist/domains/dashboard/web/assets/{chunk-GVQU2GXP-DkhKkaHd.js → chunk-GVQU2GXP-Cz71fWUR.js} +1 -1
  149. package/dist/domains/dashboard/web/assets/{chunk-IMKFNOWR-BaDSh7Jp.js → chunk-IMKFNOWR-Bqryqw0r.js} +1 -1
  150. package/dist/domains/dashboard/web/assets/{chunk-L3NEJ4N5-B4ztH2fV.js → chunk-L3NEJ4N5-CJKqYHaP.js} +1 -1
  151. package/dist/domains/dashboard/web/assets/{chunk-OSK3NFVY-BhX6NVzA.js → chunk-OSK3NFVY-C-anVJYL.js} +1 -1
  152. package/dist/domains/dashboard/web/assets/{chunk-P2QGCYS3-BCNdGJkX.js → chunk-P2QGCYS3-D-IhFZGl.js} +1 -1
  153. package/dist/domains/dashboard/web/assets/{chunk-POPQ4Y6H-DwYVuiXw.js → chunk-POPQ4Y6H-DHZ2x8cS.js} +1 -1
  154. package/dist/domains/dashboard/web/assets/{chunk-PWAF6VOD-Cyg0IO0R.js → chunk-PWAF6VOD-DfS3bSOb.js} +1 -1
  155. package/dist/domains/dashboard/web/assets/{chunk-SHT3W25Y-BZ6skx8I.js → chunk-SHT3W25Y-D3iDzF3T.js} +1 -1
  156. package/dist/domains/dashboard/web/assets/{chunk-SVP7TREG-CLIGmSO0.js → chunk-SVP7TREG-BQunJ2lh.js} +1 -1
  157. package/dist/domains/dashboard/web/assets/{chunk-TICWLB2K-BAQBbsn9.js → chunk-TICWLB2K-BaqCQLlB.js} +1 -1
  158. package/dist/domains/dashboard/web/assets/{chunk-XXDRQBXY-D07UbEpV.js → chunk-XXDRQBXY-mmlWRTLt.js} +1 -1
  159. package/dist/domains/dashboard/web/assets/classDiagram-ZZMXUADV-DXerFgpQ.js +1 -0
  160. package/dist/domains/dashboard/web/assets/classDiagram-v2-VYDZK3BY-DXerFgpQ.js +1 -0
  161. package/dist/domains/dashboard/web/assets/{cose-bilkent-JH36ORCC-wIi0mUih.js → cose-bilkent-JH36ORCC-D3cS4IXf.js} +1 -1
  162. package/dist/domains/dashboard/web/assets/{cynefin-OW5HDTMX-DBdxyuTN.js → cynefin-OW5HDTMX-DE1IHUyY.js} +1 -1
  163. package/dist/domains/dashboard/web/assets/{cynefinDiagram-5FMLGOSQ-DzO3jXxV.js → cynefinDiagram-5FMLGOSQ-DzqK0Tbz.js} +1 -1
  164. package/dist/domains/dashboard/web/assets/{dagre-GXQ25YYZ-CE7H_hZS.js → dagre-GXQ25YYZ-AI4ZWaO2.js} +1 -1
  165. package/dist/domains/dashboard/web/assets/{demo-DrJ2uuUL.js → demo-COS52Sbp.js} +8 -8
  166. package/dist/domains/dashboard/web/assets/{diagram-S7CK7UJ4-jUGQk5n-.js → diagram-S7CK7UJ4-g0XXZtEw.js} +1 -1
  167. package/dist/domains/dashboard/web/assets/{diagram-UQ7AKVKN-DaH_zW8T.js → diagram-UQ7AKVKN-Cms0TctP.js} +1 -1
  168. package/dist/domains/dashboard/web/assets/{diagram-VSXAHHWV-DmG80db0.js → diagram-VSXAHHWV-1FH11lSW.js} +1 -1
  169. package/dist/domains/dashboard/web/assets/{diagram-VX7I27RA-ltQ6niKn.js → diagram-VX7I27RA-6k2xns6T.js} +1 -1
  170. package/dist/domains/dashboard/web/assets/{diagram-Z3DM3KII-x92ex4lK.js → diagram-Z3DM3KII-7VmVYxMS.js} +1 -1
  171. package/dist/domains/dashboard/web/assets/{dist-Cf0h0n6i.js → dist-C3Eu0v0t.js} +1 -1
  172. package/dist/domains/dashboard/web/assets/{ebnfDiagram-PWID7BFC-CI2u976k.js → ebnfDiagram-PWID7BFC-CIbiadEp.js} +1 -1
  173. package/dist/domains/dashboard/web/assets/{erDiagram-RLTQ6QDP-DKs90SRd.js → erDiagram-RLTQ6QDP-Cge5wrQ7.js} +1 -1
  174. package/dist/domains/dashboard/web/assets/{es-D7xGlyQk.js → es-BBSVi8Cm.js} +1 -1
  175. package/dist/domains/dashboard/web/assets/eventmodeling-NTZA5JFV-BNDjhcIe.js +1 -0
  176. package/dist/domains/dashboard/web/assets/flowDiagram-HODETNUW-BfAyylTq.js +1 -0
  177. package/dist/domains/dashboard/web/assets/{ganttDiagram-EL5Y4UJY-D3z6G60S.js → ganttDiagram-EL5Y4UJY-Dr4gcis6.js} +1 -1
  178. package/dist/domains/dashboard/web/assets/{gitGraph-4MIJSDKK-vT1UnORT.js → gitGraph-4MIJSDKK-DzFO7GXq.js} +1 -1
  179. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-WWUBYQGX-BJmJ96jv.js → gitGraphDiagram-WWUBYQGX-jCmQLI23.js} +1 -1
  180. package/dist/domains/dashboard/web/assets/index-Cu7ImK90.js +261 -0
  181. package/dist/domains/dashboard/web/assets/index-st3h1lQU.css +1 -0
  182. package/dist/domains/dashboard/web/assets/{info-A6RAGUB7-DFeLqqen.js → info-A6RAGUB7-CFW1R5j4.js} +1 -1
  183. package/dist/domains/dashboard/web/assets/{infoDiagram-27XIBGKW-DxuY43XD.js → infoDiagram-27XIBGKW-DXRLxyIw.js} +1 -1
  184. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-5VMMS53U-DxillfWQ.js → ishikawaDiagram-5VMMS53U-27Bkcq65.js} +1 -1
  185. package/dist/domains/dashboard/web/assets/{journeyDiagram-3NMN7TZE-BPngQ3ag.js → journeyDiagram-3NMN7TZE-CNTUOJev.js} +1 -1
  186. package/dist/domains/dashboard/web/assets/{kanban-definition-UXKFOSKX-DHMLEGD4.js → kanban-definition-UXKFOSKX-wxkpxo_z.js} +1 -1
  187. package/dist/domains/dashboard/web/assets/{line-D31peBjo.js → line-COcnxdlo.js} +1 -1
  188. package/dist/domains/dashboard/web/assets/{linear-B7X50T2m.js → linear-BYi1bTXs.js} +1 -1
  189. package/dist/domains/dashboard/web/assets/{mermaid-parser.core-CX3Pzygh.js → mermaid-parser.core-j8j63RgF.js} +3 -3
  190. package/dist/domains/dashboard/web/assets/{mermaid.core-DlMjBFb6.js → mermaid.core-BU_qb_8K.js} +4 -4
  191. package/dist/domains/dashboard/web/assets/{mindmap-definition-YA3MSWOX-BKuSGF75.js → mindmap-definition-YA3MSWOX-G0BDXvKi.js} +1 -1
  192. package/dist/domains/dashboard/web/assets/{packet-AYTQ26CC-B1T8Bds9.js → packet-AYTQ26CC-JORyJlKy.js} +1 -1
  193. package/dist/domains/dashboard/web/assets/{pegDiagram-XKGWAZYB-BYgTNxLw.js → pegDiagram-XKGWAZYB-hA0fUEjQ.js} +1 -1
  194. package/dist/domains/dashboard/web/assets/{pie-WAS4IAKB-fqAjmoQw.js → pie-WAS4IAKB-gWVXoOeL.js} +1 -1
  195. package/dist/domains/dashboard/web/assets/{pieDiagram-E7YTZNPT-BAO0Ufky.js → pieDiagram-E7YTZNPT-_NamTf64.js} +1 -1
  196. package/dist/domains/dashboard/web/assets/{quadrantDiagram-AXDQQJYC-SA_1-7DT.js → quadrantDiagram-AXDQQJYC-BUU5A24c.js} +1 -1
  197. package/dist/domains/dashboard/web/assets/{radar-RG4KPBEZ-Bl_UfUle.js → radar-RG4KPBEZ-BHdo5LzP.js} +1 -1
  198. package/dist/domains/dashboard/web/assets/{railroad-74A4TZTK-yj6dkiSy.js → railroad-74A4TZTK-DT_vTugC.js} +1 -1
  199. package/dist/domains/dashboard/web/assets/railroad-abnf-HS5TGJTU-CADAqTZD.js +1 -0
  200. package/dist/domains/dashboard/web/assets/railroad-ebnf-LZEXJU2U-6x_wNdA6.js +1 -0
  201. package/dist/domains/dashboard/web/assets/railroad-peg-WCYAUIDC-D2Az23Om.js +1 -0
  202. package/dist/domains/dashboard/web/assets/{railroadDiagram-O6MQD6OU-DqV18Y46.js → railroadDiagram-O6MQD6OU-BdOuWAHc.js} +1 -1
  203. package/dist/domains/dashboard/web/assets/{requirementDiagram-BXWQKSXE-Ca2K5LuT.js → requirementDiagram-BXWQKSXE-oNwG2AbA.js} +1 -1
  204. package/dist/domains/dashboard/web/assets/{sankeyDiagram-P5KCCOFB-D9MKl-Nr.js → sankeyDiagram-P5KCCOFB-DfAhDJhA.js} +1 -1
  205. package/dist/domains/dashboard/web/assets/{sequenceDiagram-WJ2MYXX4-CXfvIzRx.js → sequenceDiagram-WJ2MYXX4-IlotrNmf.js} +1 -1
  206. package/dist/domains/dashboard/web/assets/{src-CquUPIQx.js → src-Dcq60QMV.js} +1 -1
  207. package/dist/domains/dashboard/web/assets/{stateDiagram-D77RDMKH-B7iaZHW7.js → stateDiagram-D77RDMKH-7_W4JVdo.js} +1 -1
  208. package/dist/domains/dashboard/web/assets/stateDiagram-v2-MP3YSRHH-Co817OY3.js +1 -0
  209. package/dist/domains/dashboard/web/assets/{swimlanes-42K2YHIH-OK-62yZl.js → swimlanes-42K2YHIH-d31leTl1.js} +1 -1
  210. package/dist/domains/dashboard/web/assets/swimlanesDiagram-VR7AAH4N-DYbLacQM.js +8 -0
  211. package/dist/domains/dashboard/web/assets/{timeline-definition-24CTP7MA-D0l01B1h.js → timeline-definition-24CTP7MA-nWxcdycl.js} +1 -1
  212. package/dist/domains/dashboard/web/assets/{treeView-Q6P3EWNA-Bg5u_o3A.js → treeView-Q6P3EWNA-5Mutr1Nu.js} +1 -1
  213. package/dist/domains/dashboard/web/assets/{treemap-WGGIJYW6-x89ccozk.js → treemap-WGGIJYW6-C36e-gzl.js} +1 -1
  214. package/dist/domains/dashboard/web/assets/{vennDiagram-4TSXK5OY-DV19Cqhv.js → vennDiagram-4TSXK5OY-DozZoQRR.js} +1 -1
  215. package/dist/domains/dashboard/web/assets/{wardley-WFR3VGLG-BWoeoVk5.js → wardley-WFR3VGLG-Bz4TuX9w.js} +1 -1
  216. package/dist/domains/dashboard/web/assets/{wardleyDiagram-VM6X3IG4-D4fCpoIP.js → wardleyDiagram-VM6X3IG4-DwSpGS7T.js} +1 -1
  217. package/dist/domains/dashboard/web/assets/{xychartDiagram-S5SC5T6Z-DALnOMLb.js → xychartDiagram-S5SC5T6Z-DZ3ysAHJ.js} +1 -1
  218. package/dist/domains/dashboard/web/index.html +16 -16
  219. package/dist/domains/eval/agent-learning-eval.js +1 -1
  220. package/dist/domains/eval/agent-learning-eval.js.map +1 -1
  221. package/dist/domains/project-knowledge/corpus.d.ts.map +1 -1
  222. package/dist/domains/project-knowledge/corpus.js +13 -13
  223. package/dist/domains/project-knowledge/corpus.js.map +1 -1
  224. package/dist/domains/project-knowledge/deterministic-extractors.d.ts +5 -0
  225. package/dist/domains/project-knowledge/deterministic-extractors.d.ts.map +1 -1
  226. package/dist/domains/project-knowledge/deterministic-extractors.js +381 -184
  227. package/dist/domains/project-knowledge/deterministic-extractors.js.map +1 -1
  228. package/dist/domains/project-knowledge/host-review.d.ts +19 -0
  229. package/dist/domains/project-knowledge/host-review.d.ts.map +1 -0
  230. package/dist/domains/project-knowledge/host-review.js +87 -0
  231. package/dist/domains/project-knowledge/host-review.js.map +1 -0
  232. package/dist/domains/project-knowledge/index-store.d.ts +1 -1
  233. package/dist/domains/project-knowledge/index-store.d.ts.map +1 -1
  234. package/dist/domains/project-knowledge/index-store.js +21 -12
  235. package/dist/domains/project-knowledge/index-store.js.map +1 -1
  236. package/dist/domains/project-knowledge/index.d.ts +1 -0
  237. package/dist/domains/project-knowledge/index.d.ts.map +1 -1
  238. package/dist/domains/project-knowledge/index.js +1 -0
  239. package/dist/domains/project-knowledge/index.js.map +1 -1
  240. package/dist/domains/project-knowledge/learning.d.ts +1 -0
  241. package/dist/domains/project-knowledge/learning.d.ts.map +1 -1
  242. package/dist/domains/project-knowledge/learning.js +42 -17
  243. package/dist/domains/project-knowledge/learning.js.map +1 -1
  244. package/dist/domains/project-knowledge/local-provider.d.ts +1 -0
  245. package/dist/domains/project-knowledge/local-provider.d.ts.map +1 -1
  246. package/dist/domains/project-knowledge/local-provider.js +60 -11
  247. package/dist/domains/project-knowledge/local-provider.js.map +1 -1
  248. package/dist/domains/project-knowledge/local-store.d.ts +5 -1
  249. package/dist/domains/project-knowledge/local-store.d.ts.map +1 -1
  250. package/dist/domains/project-knowledge/local-store.js +366 -116
  251. package/dist/domains/project-knowledge/local-store.js.map +1 -1
  252. package/dist/domains/project-knowledge/plugin.d.ts.map +1 -1
  253. package/dist/domains/project-knowledge/plugin.js +68 -23
  254. package/dist/domains/project-knowledge/plugin.js.map +1 -1
  255. package/dist/domains/project-knowledge/query.d.ts.map +1 -1
  256. package/dist/domains/project-knowledge/query.js +32 -3
  257. package/dist/domains/project-knowledge/query.js.map +1 -1
  258. package/dist/domains/project-knowledge/readiness.d.ts +10 -0
  259. package/dist/domains/project-knowledge/readiness.d.ts.map +1 -0
  260. package/dist/domains/project-knowledge/readiness.js +65 -0
  261. package/dist/domains/project-knowledge/readiness.js.map +1 -0
  262. package/dist/domains/project-knowledge/records.d.ts +2 -0
  263. package/dist/domains/project-knowledge/records.d.ts.map +1 -1
  264. package/dist/domains/project-knowledge/records.js +8 -0
  265. package/dist/domains/project-knowledge/records.js.map +1 -1
  266. package/dist/domains/project-knowledge/types.d.ts +16 -0
  267. package/dist/domains/project-knowledge/types.d.ts.map +1 -1
  268. package/dist/domains/workflow-contract/protected-project-path.d.ts +4 -1
  269. package/dist/domains/workflow-contract/protected-project-path.d.ts.map +1 -1
  270. package/dist/domains/workflow-contract/protected-project-path.js +25 -1
  271. package/dist/domains/workflow-contract/protected-project-path.js.map +1 -1
  272. package/dist/platform/fs/race-safe-read.d.ts +14 -0
  273. package/dist/platform/fs/race-safe-read.d.ts.map +1 -1
  274. package/dist/platform/fs/race-safe-read.js +81 -0
  275. package/dist/platform/fs/race-safe-read.js.map +1 -1
  276. package/dist/platform/install/project-registry.d.ts.map +1 -1
  277. package/dist/platform/install/project-registry.js +76 -5
  278. package/dist/platform/install/project-registry.js.map +1 -1
  279. package/dist/platform/paths/project-path-selector.d.ts +3 -0
  280. package/dist/platform/paths/project-path-selector.d.ts.map +1 -0
  281. package/dist/platform/paths/project-path-selector.js +32 -0
  282. package/dist/platform/paths/project-path-selector.js.map +1 -0
  283. package/package.json +2 -1
  284. package/dist/domains/dashboard/web/assets/architecture-7GRP2DOG-B5p4GzJf.js +0 -1
  285. package/dist/domains/dashboard/web/assets/channel-BZeSeXVb.js +0 -1
  286. package/dist/domains/dashboard/web/assets/classDiagram-ZZMXUADV-2fcinal6.js +0 -1
  287. package/dist/domains/dashboard/web/assets/classDiagram-v2-VYDZK3BY-2fcinal6.js +0 -1
  288. package/dist/domains/dashboard/web/assets/eventmodeling-NTZA5JFV-uARcGZPD.js +0 -1
  289. package/dist/domains/dashboard/web/assets/flowDiagram-HODETNUW-DXL1E4Bl.js +0 -1
  290. package/dist/domains/dashboard/web/assets/index-BG3MF8re.js +0 -261
  291. package/dist/domains/dashboard/web/assets/index-C2Hlo7VZ.css +0 -1
  292. package/dist/domains/dashboard/web/assets/railroad-abnf-HS5TGJTU-CvouMciM.js +0 -1
  293. package/dist/domains/dashboard/web/assets/railroad-ebnf-LZEXJU2U-CkYQEX72.js +0 -1
  294. package/dist/domains/dashboard/web/assets/railroad-peg-WCYAUIDC-B0uYr48F.js +0 -1
  295. package/dist/domains/dashboard/web/assets/stateDiagram-v2-MP3YSRHH-B6KoHQVe.js +0 -1
  296. package/dist/domains/dashboard/web/assets/swimlanesDiagram-VR7AAH4N-CjdOls9K.js +0 -8
@@ -1,3 +1,4 @@
1
+ import { projectPathSelectorMatches } from '../../platform/paths/project-path-selector.js';
1
2
  import { closeSync, mkdirSync, openSync, readFileSync, readSync, statSync } from 'node:fs';
2
3
  import { createHash } from 'node:crypto';
3
4
  import path from 'node:path';
@@ -6,10 +7,23 @@ import { mergeProjectKnowledgeRecord, parseProjectKnowledgeRecord, } from './rec
6
7
  import { ProjectKnowledgeIndexStore, } from './index-store.js';
7
8
  import { projectKnowledgeSourceReferenceMatchesText } from './source-validity.js';
8
9
  import { openProjectKnowledgeDatabase } from './sqlite.js';
10
+ import { hashProtectedProjectFile } from '../workflow-contract/protected-project-path.js';
9
11
  const MAX_SOURCE_VALIDATION_BYTES = 1024 * 1024;
10
12
  const PROJECT_KNOWLEDGE_SCHEMA_VERSION = '4';
13
+ const GENERATED_RECORD_MAINTENANCE = 'generated-record-maintenance-v2';
11
14
  function equalSourceVersions(left, right) {
12
- return JSON.stringify(left.sourceVersions) === JSON.stringify(right.sourceVersions);
15
+ if (left.sourceVersions.length !== right.sourceVersions.length)
16
+ return false;
17
+ const rightVersions = new Map(right.sourceVersions.map((version) => [version.source, version]));
18
+ return left.sourceVersions.every((version) => {
19
+ const other = rightVersions.get(version.source);
20
+ if (!other || version.size !== other.size || version.modifiedAt !== other.modifiedAt)
21
+ return false;
22
+ if (version.digest === undefined || other.digest === undefined) {
23
+ return version.digest === undefined && other.digest === undefined;
24
+ }
25
+ return version.digest === other.digest;
26
+ });
13
27
  }
14
28
  function recordSourceReferences(record) {
15
29
  return [
@@ -17,6 +31,116 @@ function recordSourceReferences(record) {
17
31
  ...record.relations.flatMap((relation) => relation.sources),
18
32
  ];
19
33
  }
34
+ function normalizedSemanticText(value) {
35
+ return value.trim().replace(/\s+/gu, ' ');
36
+ }
37
+ function isGeneratedModuleRecord(record) {
38
+ return (record.id.startsWith('generated-module-') && !record.id.startsWith('generated-module-overview'));
39
+ }
40
+ function normalizedGeneratedModuleConclusion(value) {
41
+ const normalized = normalizedSemanticText(value);
42
+ const separator = normalized.search(/[::]/u);
43
+ if (separator < 0)
44
+ return normalized;
45
+ const label = normalized.slice(0, separator);
46
+ const content = normalized.slice(separator + 1).replace(/[。.]+$/u, '');
47
+ const registration = /registration points|注册点/iu.test(label);
48
+ const items = content
49
+ .split(registration ? /\s*;\s*|\s*;\s*/u : /\s*、\s*|\s*,\s*/u)
50
+ .map((item) => item.trim())
51
+ .filter(Boolean)
52
+ .sort((left, right) => left.localeCompare(right));
53
+ return `${label}:${items.join('|')}`;
54
+ }
55
+ function stableSemanticSource(source) {
56
+ return {
57
+ source: normalizedProjectPath(source.source),
58
+ ...(source.anchor === undefined ? {} : { anchor: normalizedSemanticText(source.anchor) }),
59
+ };
60
+ }
61
+ function stableGeneratedModuleSource(source) {
62
+ const normalized = normalizedProjectPath(source.source);
63
+ const parts = normalized.split('/').filter(Boolean);
64
+ const moduleRoots = new Set(['app', 'domains', 'platform', 'src', 'packages']);
65
+ const stablePath = parts[0] === 'test' && parts[1] && moduleRoots.has(parts[1])
66
+ ? parts.slice(0, 3).join('/')
67
+ : parts[0] && moduleRoots.has(parts[0])
68
+ ? parts.slice(0, Math.min(2, parts.length)).join('/')
69
+ : normalized;
70
+ return {
71
+ source: stablePath,
72
+ ...(source.anchor === undefined ? {} : { anchor: normalizedSemanticText(source.anchor) }),
73
+ };
74
+ }
75
+ export function projectKnowledgeRecordSemanticFingerprint(record) {
76
+ const generatedModule = isGeneratedModuleRecord(record);
77
+ const semanticSource = generatedModule ? stableGeneratedModuleSource : stableSemanticSource;
78
+ const conclusions = record.conclusions
79
+ .map((conclusion) => ({
80
+ text: generatedModule
81
+ ? normalizedGeneratedModuleConclusion(conclusion.text)
82
+ : normalizedSemanticText(conclusion.text),
83
+ sources: [
84
+ ...new Map(conclusion.sources.map((source) => {
85
+ const normalized = semanticSource(source);
86
+ return [JSON.stringify(normalized), normalized];
87
+ })).values(),
88
+ ].sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right))),
89
+ }))
90
+ .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
91
+ const semantic = {
92
+ type: record.type,
93
+ title: normalizedSemanticText(record.title),
94
+ summary: generatedModule
95
+ ? conclusions.map((conclusion) => conclusion.text).join(' ')
96
+ : normalizedSemanticText(record.summary),
97
+ applicablePaths: [...record.applicablePaths].map(normalizedProjectPath).sort(),
98
+ operations: [...record.operations].map(normalizedSemanticText).sort(),
99
+ phases: [...(record.phases ?? [])].map(normalizedSemanticText).sort(),
100
+ conclusions,
101
+ relations: record.relations
102
+ .filter((relation) => relation.type !== 'supersedes')
103
+ .map((relation) => ({
104
+ type: relation.type,
105
+ targetId: relation.targetId,
106
+ sources: [
107
+ ...new Map(relation.sources.map((source) => {
108
+ const normalized = semanticSource(source);
109
+ return [JSON.stringify(normalized), normalized];
110
+ })).values(),
111
+ ].sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right))),
112
+ }))
113
+ .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right))),
114
+ verification: record.verification
115
+ .map((entry) => ({
116
+ command: normalizedSemanticText(entry.command),
117
+ ...(entry.expected === undefined
118
+ ? {}
119
+ : { expected: normalizedSemanticText(entry.expected) }),
120
+ }))
121
+ .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right))),
122
+ };
123
+ return createHash('sha256').update(JSON.stringify(semantic)).digest('hex').slice(0, 12);
124
+ }
125
+ function generatedRecordBaseId(id) {
126
+ return id.replace(/-v-[a-f0-9]{12}$/u, '');
127
+ }
128
+ function generatedRecordHasFeedback(record) {
129
+ return (record.authority === 'user' ||
130
+ record.applicationCount > 0 ||
131
+ record.successCount > 0 ||
132
+ record.failureCount > 0 ||
133
+ record.lastAppliedAt !== undefined);
134
+ }
135
+ function archivedGeneratedRecord(baseId, record) {
136
+ const fingerprint = projectKnowledgeRecordSemanticFingerprint(record);
137
+ return parseProjectKnowledgeRecord({
138
+ ...record,
139
+ id: `${baseId.slice(0, 112)}-v-${fingerprint}`,
140
+ state: 'superseded',
141
+ relations: record.relations.filter((relation) => relation.type !== 'supersedes'),
142
+ });
143
+ }
20
144
  function sourceReferenceIsCurrent(absolutePath, source) {
21
145
  if (source.anchor === undefined &&
22
146
  source.lineStart === undefined &&
@@ -36,7 +160,13 @@ function sourceReferenceIsCurrent(absolutePath, source) {
36
160
  const text = buffer.toString('utf8');
37
161
  return projectKnowledgeSourceReferenceMatchesText(text, source);
38
162
  }
39
- function inspectRecordSources(projectRoot, record, acceptCurrentVersions) {
163
+ async function sourceContentDigest(projectRoot, source) {
164
+ const { digest } = await hashProtectedProjectFile(projectRoot, source, {
165
+ label: `Project Knowledge source ${source}`,
166
+ });
167
+ return digest;
168
+ }
169
+ async function inspectRecordSources(projectRoot, record, acceptCurrentVersions) {
40
170
  const references = recordSourceReferences(record);
41
171
  const referenceSources = new Set(references.map((reference) => reference.source));
42
172
  const sources = [
@@ -45,40 +175,49 @@ function inspectRecordSources(projectRoot, record, acceptCurrentVersions) {
45
175
  .map((version) => version.source)
46
176
  .filter((source) => !referenceSources.has(source)),
47
177
  ];
48
- if (sources.length === 0)
49
- return { current: false, sourceVersions: record.sourceVersions };
178
+ if (sources.length === 0) {
179
+ return { current: false, complete: true, sourceVersions: record.sourceVersions };
180
+ }
50
181
  const storedVersions = new Map(record.sourceVersions.map((version) => [version.source, version]));
51
182
  const sourceVersions = [];
183
+ let isCurrent = true;
184
+ let complete = true;
52
185
  for (const source of sources) {
53
186
  try {
54
187
  const absolutePath = path.join(projectRoot, ...source.split('/'));
55
- const current = statSync(absolutePath);
56
- if (!current.isFile())
57
- return { current: false, sourceVersions: record.sourceVersions };
188
+ const fileStat = statSync(absolutePath);
189
+ if (!fileStat.isFile()) {
190
+ complete = false;
191
+ continue;
192
+ }
58
193
  const version = {
59
194
  source,
60
- size: current.size,
61
- modifiedAt: Math.trunc(current.mtimeMs),
195
+ size: fileStat.size,
196
+ modifiedAt: Math.trunc(fileStat.mtimeMs),
197
+ digest: await sourceContentDigest(projectRoot, source),
62
198
  };
63
199
  sourceVersions.push(version);
64
200
  if (!references
65
201
  .filter((reference) => reference.source === source)
66
202
  .every((reference) => sourceReferenceIsCurrent(absolutePath, reference))) {
67
- return { current: false, sourceVersions: record.sourceVersions };
203
+ isCurrent = false;
68
204
  }
69
205
  const stored = storedVersions.get(source);
70
206
  if (!acceptCurrentVersions &&
71
- (stored === undefined ||
72
- stored.size !== version.size ||
73
- stored.modifiedAt !== version.modifiedAt)) {
74
- return { current: false, sourceVersions: record.sourceVersions };
207
+ (stored === undefined || stored.digest === undefined || stored.digest !== version.digest)) {
208
+ isCurrent = false;
75
209
  }
76
210
  }
77
211
  catch {
78
- return { current: false, sourceVersions: record.sourceVersions };
212
+ isCurrent = false;
213
+ complete = false;
79
214
  }
80
215
  }
81
- return { current: true, sourceVersions };
216
+ return {
217
+ current: isCurrent,
218
+ complete,
219
+ sourceVersions: complete ? sourceVersions : record.sourceVersions,
220
+ };
82
221
  }
83
222
  function recordUsesSourceEvidence(record) {
84
223
  return recordSourceReferences(record).length > 0 || record.sourceVersions.length > 0;
@@ -184,10 +323,7 @@ function recordHasPathAssociation(record, query) {
184
323
  if (!query.path)
185
324
  return false;
186
325
  const queryPath = normalizedProjectPath(query.path);
187
- return [
188
- ...record.applicablePaths,
189
- ...recordSourceReferences(record).map((source) => source.source),
190
- ]
326
+ return record.applicablePaths
191
327
  .map(normalizedProjectPath)
192
328
  .some((candidate) => candidate === queryPath ||
193
329
  candidate.startsWith(`${queryPath}/`) ||
@@ -201,34 +337,6 @@ function recordMatchesApplicablePath(record, query) {
201
337
  .map(normalizedProjectPath)
202
338
  .some((candidate) => projectPathSelectorMatches(candidate, queryPath));
203
339
  }
204
- function projectPathSelectorMatches(selector, projectPath) {
205
- if (!/[?*]/u.test(selector)) {
206
- return (selector === projectPath ||
207
- projectPath.startsWith(selector.endsWith('/') ? selector : `${selector}/`));
208
- }
209
- let pattern = '^';
210
- for (let index = 0; index < selector.length; index += 1) {
211
- const character = selector[index];
212
- const next = selector[index + 1];
213
- if (character === '*' && next === '*') {
214
- if (selector[index + 2] === '/') {
215
- pattern += '(?:.*/)?';
216
- index += 2;
217
- }
218
- else {
219
- pattern += '.*';
220
- index += 1;
221
- }
222
- }
223
- else if (character === '*')
224
- pattern += '[^/]*';
225
- else if (character === '?')
226
- pattern += '[^/]';
227
- else
228
- pattern += character.replace(/[\\^$.*+?()[\]{}|]/gu, '\\$&');
229
- }
230
- return new RegExp(`${pattern}$`, 'u').test(projectPath);
231
- }
232
340
  function recordHasOperationAssociation(record, query) {
233
341
  if (!query.operation)
234
342
  return false;
@@ -237,17 +345,15 @@ function recordHasOperationAssociation(record, query) {
237
345
  }
238
346
  function recordMatchesSelectors(record, query) {
239
347
  if (record.applicablePaths.length > 0) {
240
- if (!query.path || !recordMatchesApplicablePath(record, query))
348
+ if (query.path && !recordMatchesApplicablePath(record, query))
241
349
  return false;
242
350
  }
243
351
  if (record.operations.length > 0) {
244
- if (!query.operation || !recordHasOperationAssociation(record, query))
352
+ if (query.operation && !recordHasOperationAssociation(record, query))
245
353
  return false;
246
354
  }
247
355
  const phases = record.phases ?? [];
248
- if (phases.length > 0) {
249
- if (!query.phase)
250
- return false;
356
+ if (phases.length > 0 && query.phase) {
251
357
  const phase = query.phase.toLocaleLowerCase();
252
358
  if (!phases.some((candidate) => candidate.toLocaleLowerCase() === phase))
253
359
  return false;
@@ -280,11 +386,13 @@ export class ProjectKnowledgeLocalStore {
280
386
  repositoryId;
281
387
  workspaceId;
282
388
  projectRoot;
389
+ reportDiagnostic;
283
390
  database;
284
391
  indexStore;
285
392
  closed = false;
286
393
  constructor(options) {
287
394
  this.projectRoot = path.resolve(options.projectRoot);
395
+ this.reportDiagnostic = options.reportDiagnostic;
288
396
  const location = resolveProjectKnowledgeStorageLocation(this.projectRoot, options.storageRoot ?? options.cacheRoot);
289
397
  this.databasePath = location.databasePath;
290
398
  this.repositoryId = location.repositoryId;
@@ -292,6 +400,7 @@ export class ProjectKnowledgeLocalStore {
292
400
  mkdirSync(path.dirname(this.databasePath), { recursive: true });
293
401
  this.database = this.acquireDatabase();
294
402
  this.initializeSchema();
403
+ this.maintainGeneratedRecords();
295
404
  this.indexStore = new ProjectKnowledgeIndexStore({
296
405
  projectRoot: options.projectRoot,
297
406
  ...(options.storageRoot ? { cacheRoot: options.storageRoot } : {}),
@@ -337,6 +446,20 @@ export class ProjectKnowledgeLocalStore {
337
446
  .all(...values, limit);
338
447
  return rows.map((row) => parseProjectKnowledgeRecord(JSON.parse(row.payload_json)));
339
448
  }
449
+ projectCounts(projectId) {
450
+ const rows = this.requireDatabase()
451
+ .prepare('SELECT state, COUNT(*) AS count FROM pk_records WHERE project_id = ? GROUP BY state')
452
+ .all(projectId);
453
+ const counts = { active: 0, trial: 0, proven: 0, enforced: 0, superseded: 0, total: 0 };
454
+ for (const row of rows) {
455
+ const count = typeof row.count === 'bigint' ? Number(row.count) : row.count;
456
+ counts[row.state] = count;
457
+ counts.total += count;
458
+ if (row.state !== 'superseded')
459
+ counts.active += count;
460
+ }
461
+ return counts;
462
+ }
340
463
  read(id) {
341
464
  const row = this.requireDatabase()
342
465
  .prepare('SELECT payload_json FROM pk_records WHERE id = ?')
@@ -400,9 +523,12 @@ export class ProjectKnowledgeLocalStore {
400
523
  }
401
524
  }
402
525
  searchRecords(query) {
403
- const terms = [...query.terms, ...query.strongTerms, ...query.phraseTerms]
404
- .map((term) => term.toLocaleLowerCase())
405
- .filter(Boolean);
526
+ const terms = [
527
+ ...new Set([...query.terms, ...query.strongTerms, ...query.phraseTerms]
528
+ .map((term) => term.toLocaleLowerCase())
529
+ .filter(Boolean)),
530
+ ];
531
+ const discovery = query.path === undefined && query.operation === undefined && query.phase === undefined;
406
532
  const applicableRecords = this.list().filter((record) => record.state !== 'superseded' && recordMatchesSelectors(record, query));
407
533
  const direct = applicableRecords
408
534
  .map((record) => {
@@ -415,8 +541,15 @@ export class ProjectKnowledgeLocalStore {
415
541
  operationAssociation: recordHasOperationAssociation(record, query),
416
542
  };
417
543
  })
418
- .filter(({ matches }) => terms.length === 0 || matches > 0)
544
+ .filter(({ matches, pathAssociation }) => terms.length === 0
545
+ ? pathAssociation || query.path === undefined
546
+ : matches > 0 || pathAssociation)
419
547
  .sort((left, right) => {
548
+ // During task discovery, a directly relevant trial lesson must remain
549
+ // discoverable among broad generated models. Known-scope activation
550
+ // retains the established authority/lifecycle ordering below.
551
+ if (discovery && left.matches !== right.matches)
552
+ return right.matches - left.matches;
420
553
  const lifecycle = recordLifecycleRank(right.record) - recordLifecycleRank(left.record);
421
554
  if (lifecycle !== 0)
422
555
  return lifecycle;
@@ -435,27 +568,35 @@ export class ProjectKnowledgeLocalStore {
435
568
  const type = RECORD_TYPE_RANK[left.record.type] - RECORD_TYPE_RANK[right.record.type];
436
569
  if (type !== 0)
437
570
  return type;
438
- const source = recordResultSource(left.record).localeCompare(recordResultSource(right.record));
439
- return source !== 0 ? source : left.record.id.localeCompare(right.record.id);
571
+ return left.record.id.localeCompare(right.record.id);
440
572
  });
441
573
  const recordsById = new Map(applicableRecords.map((record) => [record.id, record]));
442
- const ranked = direct.map(({ record, matches }) => ({ record, matches }));
574
+ const ranked = direct.map(({ record, matches, pathAssociation }) => ({
575
+ record,
576
+ matches,
577
+ pathAssociation,
578
+ }));
443
579
  const seen = new Set(ranked.map(({ record }) => record.id));
444
580
  for (const { record } of direct) {
445
581
  for (const relation of record.relations) {
446
582
  const related = recordsById.get(relation.targetId);
447
583
  if (!related || seen.has(related.id))
448
584
  continue;
449
- ranked.push({ record: related, matches: 0, relationSource: relation.sources[0] });
585
+ ranked.push({
586
+ record: related,
587
+ matches: 0,
588
+ pathAssociation: false,
589
+ relationSource: relation.sources[0],
590
+ });
450
591
  seen.add(related.id);
451
592
  }
452
593
  }
453
- return ranked.slice(0, 40).map(({ record, matches, relationSource }) => ({
594
+ return ranked.slice(0, 40).map(({ record, matches, pathAssociation, relationSource }) => ({
454
595
  source: relationSource ? sourceReferenceLabel(relationSource) : recordResultSource(record),
455
596
  title: record.title,
456
597
  record,
457
598
  content: `${record.summary}\n${record.conclusions.map((conclusion) => conclusion.text).join('\n')}`.slice(0, 1600),
458
- score: matches,
599
+ score: matches + (pathAssociation ? 100 : 0),
459
600
  }));
460
601
  }
461
602
  async apply(mutation) {
@@ -465,7 +606,7 @@ export class ProjectKnowledgeLocalStore {
465
606
  for (const candidate of candidates) {
466
607
  if (candidate.state === 'superseded' || (mutation.id && mutation.id !== candidate.id))
467
608
  continue;
468
- const inspection = inspectRecordSources(this.projectRoot, candidate, false);
609
+ const inspection = await inspectRecordSources(this.projectRoot, candidate, candidate.authority === 'user' && candidate.sourceVersions.length === 0);
469
610
  const verificationCurrent = verificationCommandsAreAvailable(this.projectRoot, candidate);
470
611
  const state = !verificationCurrent
471
612
  ? 'superseded'
@@ -474,22 +615,24 @@ export class ProjectKnowledgeLocalStore {
474
615
  ? 'enforced'
475
616
  : 'proven'
476
617
  : inspection.current
477
- ? candidate.state === 'enforced'
478
- ? 'enforced'
479
- : 'proven'
618
+ ? candidate.state
480
619
  : 'superseded';
481
620
  if (state !== candidate.state ||
482
621
  (inspection.current &&
483
622
  JSON.stringify(inspection.sourceVersions) !== JSON.stringify(candidate.sourceVersions))) {
623
+ const hasLegacySourceVersion = candidate.sourceVersions.some((version) => version.digest === undefined);
624
+ const nextSourceVersions = inspection.complete && (inspection.current || hasLegacySourceVersion)
625
+ ? inspection.sourceVersions
626
+ : candidate.sourceVersions;
484
627
  this.write({
485
628
  ...candidate,
486
629
  state,
487
- sourceVersions: inspection.current
488
- ? inspection.sourceVersions
489
- : candidate.sourceVersions,
630
+ sourceVersions: nextSourceVersions,
490
631
  updatedAt: new Date().toISOString(),
491
632
  });
492
- changed = true;
633
+ changed ||=
634
+ state !== candidate.state ||
635
+ JSON.stringify(nextSourceVersions) !== JSON.stringify(candidate.sourceVersions);
493
636
  }
494
637
  }
495
638
  const records = this.list({ projectId: mutation.projectId });
@@ -526,21 +669,62 @@ export class ProjectKnowledgeLocalStore {
526
669
  !verificationCommandsAreConfirmed(this.projectRoot, parsedIncoming)
527
670
  ? parseProjectKnowledgeRecord({ ...parsedIncoming, state: 'proven' })
528
671
  : parsedIncoming;
672
+ if (current && current.authority === 'user' && incoming.authority !== 'user') {
673
+ return { kind: mutation.kind, changed: false, record: current, diagnostics: [] };
674
+ }
529
675
  if (current?.state === 'superseded' &&
530
676
  incoming.authority !== 'user' &&
531
677
  equalSourceVersions(current, incoming)) {
532
678
  return { kind: mutation.kind, changed: false, record: current, diagnostics: [] };
533
679
  }
534
- if (current?.state === 'superseded' && incoming.authority !== 'user') {
535
- const versioned = versionProjectKnowledgeRecord(current, incoming);
536
- const existingVersion = this.read(versioned.id);
537
- const next = existingVersion
538
- ? mergeProjectKnowledgeRecord(existingVersion, versioned)
539
- : versioned;
680
+ if (current && incoming.authority !== 'user') {
681
+ const currentSemantic = projectKnowledgeRecordSemanticFingerprint(current);
682
+ const incomingSemantic = projectKnowledgeRecordSemanticFingerprint(incoming);
683
+ if (current.state !== 'superseded' &&
684
+ currentSemantic === incomingSemantic &&
685
+ equalSourceVersions(current, incoming)) {
686
+ return { kind: mutation.kind, changed: false, record: current, diagnostics: [] };
687
+ }
688
+ if (currentSemantic === incomingSemantic) {
689
+ const next = parseProjectKnowledgeRecord({
690
+ ...incoming,
691
+ state: current.state === 'enforced' ? 'enforced' : incoming.state,
692
+ applicationCount: current.applicationCount,
693
+ successCount: current.successCount,
694
+ failureCount: current.failureCount,
695
+ ...(current.lastAppliedAt === undefined
696
+ ? {}
697
+ : { lastAppliedAt: current.lastAppliedAt }),
698
+ });
699
+ this.write(next);
700
+ return {
701
+ kind: mutation.kind,
702
+ changed: JSON.stringify(current) !== JSON.stringify(next),
703
+ record: next,
704
+ diagnostics: [],
705
+ };
706
+ }
707
+ const archived = archivedGeneratedRecord(incoming.id, current);
708
+ const existingArchive = this.read(archived.id);
709
+ if (!existingArchive || !generatedRecordHasFeedback(existingArchive))
710
+ this.write(archived);
711
+ const relationSource = recordSourceReferences(incoming)[0] ??
712
+ (incoming.sourceVersions[0] ? { source: incoming.sourceVersions[0].source } : undefined);
713
+ const next = parseProjectKnowledgeRecord({
714
+ ...incoming,
715
+ relations: relationSource === undefined
716
+ ? incoming.relations
717
+ : [
718
+ ...incoming.relations
719
+ .filter((relation) => relation.type !== 'supersedes')
720
+ .slice(0, 15),
721
+ { type: 'supersedes', targetId: archived.id, sources: [relationSource] },
722
+ ],
723
+ });
540
724
  this.write(next);
541
725
  return {
542
726
  kind: mutation.kind,
543
- changed: !existingVersion || JSON.stringify(existingVersion) !== JSON.stringify(next),
727
+ changed: true,
544
728
  record: next,
545
729
  diagnostics: [],
546
730
  };
@@ -593,7 +777,7 @@ export class ProjectKnowledgeLocalStore {
593
777
  updatedAt: mutation.updatedAt,
594
778
  });
595
779
  const corrected = parseProjectKnowledgeRecord({ ...correctedBase, state: 'proven' });
596
- const inspection = inspectRecordSources(this.projectRoot, corrected, true);
780
+ const inspection = await inspectRecordSources(this.projectRoot, corrected, true);
597
781
  const next = parseProjectKnowledgeRecord({
598
782
  ...corrected,
599
783
  state: corrected.authority === 'user' && !recordUsesSourceEvidence(corrected)
@@ -781,24 +965,119 @@ export class ProjectKnowledgeLocalStore {
781
965
  }
782
966
  database.exec('BEGIN IMMEDIATE;');
783
967
  try {
784
- database.exec([
785
- 'DROP TABLE IF EXISTS pk_records;',
786
- 'DROP TABLE IF EXISTS pk_applied_mutations;',
787
- 'DROP TABLE IF EXISTS pk_application_outcomes;',
788
- 'DROP TABLE IF EXISTS pk_feedback_state;',
789
- 'DELETE FROM pk_meta;',
790
- ].join('\n'));
791
968
  this.createRecordSchema(database);
792
969
  database
793
- .prepare("INSERT INTO pk_meta(key, value) VALUES ('schema_version', ?)")
970
+ .prepare("INSERT INTO pk_meta(key, value) VALUES ('schema_version', ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value")
794
971
  .run(PROJECT_KNOWLEDGE_SCHEMA_VERSION);
795
972
  database.exec('COMMIT;');
796
973
  }
797
974
  catch (error) {
798
975
  database.exec('ROLLBACK;');
976
+ this.reportDiagnostic?.({
977
+ code: 'record-migration-failed',
978
+ message: '项目知识存储升级失败,已回滚并保留原有记录。',
979
+ });
799
980
  throw error;
800
981
  }
801
982
  }
983
+ maintainGeneratedRecords() {
984
+ const database = this.requireDatabase();
985
+ database.exec('BEGIN IMMEDIATE;');
986
+ try {
987
+ const maintenanceComplete = database
988
+ .prepare('SELECT value FROM pk_meta WHERE key = ?')
989
+ .get(GENERATED_RECORD_MAINTENANCE)?.value === 'complete';
990
+ const rows = database
991
+ .prepare('SELECT payload_json FROM pk_records')
992
+ .all();
993
+ const records = rows.map((row) => parseProjectKnowledgeRecord(JSON.parse(row.payload_json)));
994
+ const protectedIds = new Set();
995
+ for (const row of database
996
+ .prepare('SELECT record_id FROM pk_application_outcomes UNION SELECT record_id FROM pk_feedback_state')
997
+ .all())
998
+ protectedIds.add(row.record_id);
999
+ const hasFeedback = (record) => protectedIds.has(record.id) || generatedRecordHasFeedback(record);
1000
+ const deleteRecord = database.prepare('DELETE FROM pk_records WHERE id = ?');
1001
+ const obsolete = records.filter((record) => (record.id.startsWith('generated-knowledge-corpus') ||
1002
+ record.id.startsWith('generated-module-overview') ||
1003
+ // The first module-level maintenance rebuilds unreviewed rows into one canonical set.
1004
+ (!maintenanceComplete && isGeneratedModuleRecord(record))) &&
1005
+ !hasFeedback(record));
1006
+ for (const record of obsolete)
1007
+ deleteRecord.run(record.id);
1008
+ const candidates = records.filter((record) => !obsolete.some((entry) => entry.id === record.id) &&
1009
+ (record.id.startsWith('generated-project-map') ||
1010
+ record.id.startsWith('generated-build-test') ||
1011
+ (record.id.startsWith('generated-module-') &&
1012
+ !record.id.startsWith('generated-module-overview'))));
1013
+ const groups = new Map();
1014
+ for (const record of candidates) {
1015
+ const baseId = generatedRecordBaseId(record.id);
1016
+ const group = groups.get(baseId) ?? [];
1017
+ group.push(record);
1018
+ groups.set(baseId, group);
1019
+ }
1020
+ for (const [baseId, group] of groups) {
1021
+ const protectedRecords = group.filter(hasFeedback);
1022
+ const disposable = group.filter((record) => !hasFeedback(record));
1023
+ const bySemantic = new Map();
1024
+ for (const record of disposable) {
1025
+ const fingerprint = projectKnowledgeRecordSemanticFingerprint(record);
1026
+ const versions = bySemantic.get(fingerprint) ?? [];
1027
+ versions.push(record);
1028
+ bySemantic.set(fingerprint, versions);
1029
+ }
1030
+ if (protectedRecords.length > 0) {
1031
+ for (const versions of bySemantic.values()) {
1032
+ versions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
1033
+ for (const duplicate of versions.slice(1))
1034
+ deleteRecord.run(duplicate.id);
1035
+ }
1036
+ continue;
1037
+ }
1038
+ if (disposable.length === 0)
1039
+ continue;
1040
+ const active = disposable
1041
+ .filter((record) => record.state !== 'superseded')
1042
+ .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt))[0];
1043
+ const canonical = [];
1044
+ const activeSemantic = active
1045
+ ? projectKnowledgeRecordSemanticFingerprint(active)
1046
+ : undefined;
1047
+ if (active) {
1048
+ canonical.push(parseProjectKnowledgeRecord({
1049
+ ...active,
1050
+ id: baseId,
1051
+ relations: active.relations.filter((relation) => relation.type !== 'supersedes'),
1052
+ }));
1053
+ }
1054
+ for (const [semantic, versions] of bySemantic) {
1055
+ if (semantic === activeSemantic)
1056
+ continue;
1057
+ versions.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
1058
+ canonical.push(archivedGeneratedRecord(baseId, versions[0]));
1059
+ }
1060
+ if (canonical.length === disposable.length &&
1061
+ canonical.every((record) => disposable.some((existing) => JSON.stringify(existing) === JSON.stringify(record))))
1062
+ continue;
1063
+ for (const record of disposable)
1064
+ deleteRecord.run(record.id);
1065
+ for (const record of canonical)
1066
+ this.writeRecord(database, record);
1067
+ }
1068
+ database
1069
+ .prepare('INSERT INTO pk_meta(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value')
1070
+ .run(GENERATED_RECORD_MAINTENANCE, 'complete');
1071
+ database.exec('COMMIT;');
1072
+ }
1073
+ catch {
1074
+ database.exec('ROLLBACK;');
1075
+ this.reportDiagnostic?.({
1076
+ code: 'record-maintenance-failed',
1077
+ message: '项目知识历史整理失败,已回滚并保留原有记录。',
1078
+ });
1079
+ }
1080
+ }
802
1081
  createRecordSchema(database) {
803
1082
  database.exec([
804
1083
  'CREATE TABLE IF NOT EXISTS pk_records (id TEXT PRIMARY KEY, project_id TEXT NOT NULL, type TEXT NOT NULL, state TEXT NOT NULL, authority TEXT NOT NULL, payload_json TEXT NOT NULL, source_versions_json TEXT NOT NULL, updated_at TEXT NOT NULL);',
@@ -881,33 +1160,4 @@ export function readProjectKnowledgeStoreSnapshot(databasePath) {
881
1160
  database.close();
882
1161
  }
883
1162
  }
884
- function versionProjectKnowledgeRecord(superseded, incoming) {
885
- const signature = createHash('sha256')
886
- .update(JSON.stringify({
887
- type: incoming.type,
888
- title: incoming.title,
889
- summary: incoming.summary,
890
- conclusions: incoming.conclusions,
891
- verification: incoming.verification,
892
- sourceVersions: incoming.sourceVersions,
893
- }))
894
- .digest('hex')
895
- .slice(0, 12);
896
- const id = `${incoming.id.slice(0, 112)}-v-${signature}`;
897
- const source = recordSourceReferences(incoming)[0] ??
898
- (incoming.sourceVersions[0] === undefined
899
- ? undefined
900
- : { source: incoming.sourceVersions[0].source });
901
- const retainedRelations = incoming.relations.filter((relation) => relation.type !== 'supersedes' || relation.targetId !== superseded.id);
902
- return parseProjectKnowledgeRecord({
903
- ...incoming,
904
- id,
905
- relations: source === undefined
906
- ? incoming.relations
907
- : [
908
- ...retainedRelations.slice(0, 15),
909
- { type: 'supersedes', targetId: superseded.id, sources: [source] },
910
- ],
911
- });
912
- }
913
1163
  //# sourceMappingURL=local-store.js.map