@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,10 +1,26 @@
1
+ import { createHash } from 'node:crypto';
1
2
  import { promises as fs } from 'node:fs';
2
3
  import path from 'node:path';
3
- import { readProtectedProjectFile } from '../workflow-contract/protected-project-path.js';
4
+ import { hashProtectedProjectFile, readProtectedProjectFile, } from '../workflow-contract/protected-project-path.js';
4
5
  import { resolveStableProjectId } from '../../platform/paths/project-identity.js';
5
6
  const MAX_READ_BYTES = 64 * 1024;
6
7
  const MAX_EXTRACTION_MS = 1_500;
8
+ const MAX_MODULES = 64;
9
+ const MAX_SOURCE_FILES = 512;
7
10
  const MODULE_ROOTS = ['app', 'domains', 'platform', 'src', 'packages'];
11
+ const CODE_EXTENSIONS = new Set([
12
+ '.ts',
13
+ '.tsx',
14
+ '.js',
15
+ '.jsx',
16
+ '.mjs',
17
+ '.cjs',
18
+ '.py',
19
+ '.go',
20
+ '.java',
21
+ '.rs',
22
+ ]);
23
+ const TS_JS_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
8
24
  const SKIPPED_PROJECT_DIRECTORIES = new Set([
9
25
  '.git',
10
26
  '.comet',
@@ -39,8 +55,8 @@ function checkDeadline(deadline) {
39
55
  if (Date.now() > deadline)
40
56
  throw new ExtractionDeadlineExceeded();
41
57
  }
42
- function source(source, anchor) {
43
- return { source, ...(anchor === undefined ? {} : { anchor }) };
58
+ function source(sourcePath, anchor) {
59
+ return { source: sourcePath, ...(anchor === undefined ? {} : { anchor }) };
44
60
  }
45
61
  function recordBase(id, type, title, summary, conclusions, options = {}) {
46
62
  return {
@@ -56,11 +72,17 @@ function recordBase(id, type, title, summary, conclusions, options = {}) {
56
72
  verification: options.verification ?? [],
57
73
  };
58
74
  }
59
- async function realProjectFiles(root, max = 200, deadline = Number.POSITIVE_INFINITY) {
75
+ async function realProjectFiles(root, max = 200, deadline = Number.POSITIVE_INFINITY, includeFile = () => true, allowPartialOnDeadline = false) {
60
76
  const result = [];
77
+ const deadlineReached = () => {
78
+ if (Date.now() <= deadline)
79
+ return false;
80
+ if (allowPartialOnDeadline)
81
+ return true;
82
+ throw new ExtractionDeadlineExceeded();
83
+ };
61
84
  const visit = async (directory) => {
62
- checkDeadline(deadline);
63
- if (result.length >= max)
85
+ if (deadlineReached() || result.length >= max)
64
86
  return;
65
87
  let entries;
66
88
  try {
@@ -70,7 +92,8 @@ async function realProjectFiles(root, max = 200, deadline = Number.POSITIVE_INFI
70
92
  return;
71
93
  }
72
94
  for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
73
- checkDeadline(deadline);
95
+ if (deadlineReached())
96
+ return;
74
97
  if (result.length >= max ||
75
98
  entry.name.startsWith('.') ||
76
99
  SKIPPED_PROJECT_DIRECTORIES.has(entry.name))
@@ -78,46 +101,29 @@ async function realProjectFiles(root, max = 200, deadline = Number.POSITIVE_INFI
78
101
  const target = path.join(directory, entry.name);
79
102
  if (entry.isSymbolicLink())
80
103
  continue;
81
- if (entry.isDirectory()) {
104
+ if (entry.isDirectory())
82
105
  await visit(target);
83
- }
84
106
  else if (entry.isFile() &&
85
- !SKIPPED_PROJECT_FILE_EXTENSIONS.has(path.extname(entry.name).toLocaleLowerCase())) {
107
+ includeFile(target) &&
108
+ !SKIPPED_PROJECT_FILE_EXTENSIONS.has(path.extname(entry.name).toLocaleLowerCase()))
86
109
  result.push(target);
87
- }
88
110
  }
89
111
  };
90
112
  await visit(root);
91
113
  return result;
92
114
  }
93
- async function changedProjectFiles(root, changedPaths, max, deadline) {
94
- const result = [];
95
- for (const value of changedPaths.slice(0, max)) {
96
- checkDeadline(deadline);
97
- const relativePath = value.replaceAll('\\', '/').replace(/^\.\//u, '');
98
- if (!relativePath || relativePath.split('/').some((part) => part === '..'))
99
- continue;
100
- const target = path.resolve(root, relativePath);
101
- try {
102
- const stat = await fs.lstat(target);
103
- if (stat.isSymbolicLink())
104
- continue;
105
- if (stat.isFile())
106
- result.push(target);
107
- else if (stat.isDirectory())
108
- result.push(...(await realProjectFiles(target, max, deadline)));
109
- }
110
- catch {
111
- // Deleted paths are handled by the index and do not produce a record source.
112
- }
113
- if (result.length >= max)
114
- break;
115
- }
116
- return result.slice(0, max);
117
- }
118
115
  function relative(root, file) {
119
116
  return path.relative(root, file).replaceAll(path.sep, '/');
120
117
  }
118
+ async function pathIsDirectory(target) {
119
+ try {
120
+ const stat = await fs.lstat(target);
121
+ return stat.isDirectory() && !stat.isSymbolicLink();
122
+ }
123
+ catch {
124
+ return false;
125
+ }
126
+ }
121
127
  async function firstExistingSource(root, candidates, deadline = Number.POSITIVE_INFINITY) {
122
128
  for (const candidate of candidates) {
123
129
  checkDeadline(deadline);
@@ -130,8 +136,7 @@ async function firstExistingSource(root, candidates, deadline = Number.POSITIVE_
130
136
  // Try the next bounded candidate.
131
137
  }
132
138
  }
133
- const files = await realProjectFiles(root, 1, deadline);
134
- return files[0] ? relative(root, files[0]) : null;
139
+ return null;
135
140
  }
136
141
  async function readText(root, relativePath, deadline = Number.POSITIVE_INFINITY) {
137
142
  try {
@@ -142,157 +147,363 @@ async function readText(root, relativePath, deadline = Number.POSITIVE_INFINITY)
142
147
  return null;
143
148
  }
144
149
  }
145
- async function projectMapRecord(root, deadline, changedPaths, language = 'zh-CN') {
150
+ async function topLevelProjectDirectories(root, deadline) {
151
+ checkDeadline(deadline);
152
+ let entries;
153
+ try {
154
+ entries = await fs.readdir(root, { withFileTypes: true });
155
+ }
156
+ catch {
157
+ return [];
158
+ }
159
+ return entries
160
+ .filter((entry) => entry.isDirectory() &&
161
+ !entry.isSymbolicLink() &&
162
+ !entry.name.startsWith('.') &&
163
+ !SKIPPED_PROJECT_DIRECTORIES.has(entry.name))
164
+ .map((entry) => entry.name)
165
+ .sort((left, right) => left.localeCompare(right))
166
+ .slice(0, 30);
167
+ }
168
+ async function projectMapRecord(root, deadline, language) {
146
169
  const manifest = await firstExistingSource(root, ['package.json', 'pnpm-workspace.yaml', 'README.md'], deadline);
147
170
  const config = await firstExistingSource(root, ['.comet/config.yaml', 'tsconfig.json', 'vite.config.ts'], deadline);
148
- const files = changedPaths && changedPaths.length > 0
149
- ? await changedProjectFiles(root, changedPaths, 500, deadline)
150
- : await realProjectFiles(root, 500, deadline);
151
- const representatives = new Map();
152
- for (const file of files) {
153
- const relativeFile = relative(root, file);
154
- const directory = relativeFile.split('/')[0];
155
- if (directory && !representatives.has(directory))
156
- representatives.set(directory, relativeFile);
157
- }
158
- const representativeSources = [...representatives.entries()]
159
- .slice(0, 30)
160
- .map(([, file]) => source(file));
161
- const directories = [...representatives.keys()].slice(0, representativeSources.length);
162
- const sources = [manifest, config]
171
+ const directories = await topLevelProjectDirectories(root, deadline);
172
+ const representatives = await Promise.all(directories.map(async (directory) => {
173
+ const files = await realProjectFiles(path.join(root, directory), 1, deadline);
174
+ return files[0] ? relative(root, files[0]) : null;
175
+ }));
176
+ const sources = [manifest, config, ...representatives]
163
177
  .filter((value) => value !== null)
164
- .map((value) => source(value))
165
- .concat(representativeSources)
166
- .filter((reference, index, values) => values.findIndex((candidate) => candidate.source === reference.source) === index)
167
- .slice(0, 32);
168
- if (sources.length === 0) {
169
- const fallback = await firstExistingSource(root, [], deadline);
170
- if (fallback)
171
- sources.push(source(fallback));
172
- }
178
+ .filter((value, index, values) => values.indexOf(value) === index)
179
+ .slice(0, 32)
180
+ .map((value) => source(value));
181
+ if (sources.length === 0)
182
+ return null;
173
183
  return recordBase('generated-project-map', 'topology', language === 'en' ? 'Project structure overview' : '项目结构概览', language === 'en'
174
- ? 'Project entry points and layers derived from repository directories, configuration, and manifests.'
175
- : '从仓库目录、项目配置和 manifest 生成的项目入口与分层概览。', [
184
+ ? 'Project layers derived from real repository directories, configuration, and manifests.'
185
+ : '从仓库中的真实目录、项目配置和 manifest 生成项目分层概览。', [
176
186
  {
177
187
  text: language === 'en'
178
- ? `Primary project directories: ${directories.join(', ') || 'to be confirmed from the current project'}.`
179
- : `项目包含主要目录:${directories.join('、') || '待从当前项目确认'}。`,
188
+ ? `Primary project directories: ${directories.join(', ') || 'none discovered'}.`
189
+ : `项目主要目录:${directories.join('、') || '未发现'}。`,
180
190
  sources,
181
191
  },
182
192
  ], { applicablePaths: directories.map((directory) => `${directory}/`) });
183
193
  }
184
- async function moduleOverviewRecord(root, deadline, changedPaths, language = 'zh-CN') {
185
- const files = [];
194
+ function normalizedModuleSlug(modulePath) {
195
+ return modulePath
196
+ .toLocaleLowerCase()
197
+ .replaceAll('/', '-')
198
+ .replace(/[^a-z0-9._-]+/gu, '-')
199
+ .replace(/^-+|-+$/gu, '');
200
+ }
201
+ function moduleRecordId(modulePath, duplicateSlugs) {
202
+ const slug = normalizedModuleSlug(modulePath);
203
+ const base = `generated-module-${slug || 'root'}`;
204
+ if (base.length <= 128 && !duplicateSlugs.has(slug))
205
+ return base;
206
+ const digest = createHash('sha256').update(modulePath).digest('hex').slice(0, 10);
207
+ return `${base.slice(0, 114).replace(/[-._]+$/u, '')}-${digest}`;
208
+ }
209
+ async function discoverProjectModules(root, deadline, reportDiagnostic) {
210
+ const paths = [];
186
211
  for (const moduleRoot of MODULE_ROOTS) {
187
212
  checkDeadline(deadline);
213
+ const absoluteRoot = path.join(root, moduleRoot);
214
+ if (!(await pathIsDirectory(absoluteRoot)))
215
+ continue;
216
+ let entries;
188
217
  try {
189
- const stat = await fs.lstat(path.join(root, moduleRoot));
190
- if (!stat.isDirectory() || stat.isSymbolicLink())
191
- continue;
192
- if (changedPaths && changedPaths.length > 0) {
193
- files.push(...(await changedProjectFiles(root, changedPaths.filter((changed) => changed === moduleRoot || changed.startsWith(`${moduleRoot}/`)), 48, deadline)));
194
- }
195
- else {
196
- files.push(...(await realProjectFiles(path.join(root, moduleRoot), 48, deadline)));
197
- }
218
+ entries = await fs.readdir(absoluteRoot, { withFileTypes: true });
198
219
  }
199
220
  catch {
200
- // Missing module root is normal.
221
+ continue;
201
222
  }
223
+ const children = entries
224
+ .filter((entry) => entry.isDirectory() &&
225
+ !entry.isSymbolicLink() &&
226
+ !entry.name.startsWith('.') &&
227
+ !SKIPPED_PROJECT_DIRECTORIES.has(entry.name))
228
+ .map((entry) => `${moduleRoot}/${entry.name}`);
229
+ if (children.length > 0)
230
+ paths.push(...children);
231
+ else if (entries.some((entry) => entry.isFile() && CODE_EXTENSIONS.has(path.extname(entry.name).toLowerCase())))
232
+ paths.push(moduleRoot);
202
233
  }
203
- const selected = files
204
- .filter((file) => /\.(?:ts|tsx|js|jsx|mjs|py|go|java|rs)$/u.test(file))
205
- .slice(0, 24);
206
- const sourceFiles = selected.length > 0
207
- ? selected
208
- : changedPaths && changedPaths.length > 0
209
- ? await changedProjectFiles(root, changedPaths, 1, deadline)
210
- : await realProjectFiles(root, 1, deadline);
211
- const names = [
212
- ...new Set(sourceFiles.map((file) => relative(root, file).split('/').slice(0, 2).join('/'))),
213
- ].filter(Boolean);
214
- const sourceRefs = sourceFiles.slice(0, 32).map((file) => source(relative(root, file)));
215
- const relationTargets = names
216
- .slice(0, 8)
217
- .map((name) => (language === 'en' ? `module ${name}` : `模块 ${name}`))
218
- .join(language === 'en' ? ', ' : '、');
219
- const evidence = [];
220
- const registrationSources = [];
221
- for (const file of sourceFiles.slice(0, 6)) {
222
- checkDeadline(deadline);
223
- const text = await readText(root, relative(root, file), deadline);
224
- if (!text)
234
+ const unique = [...new Set(paths)].sort((left, right) => left.localeCompare(right));
235
+ if (unique.length > MAX_MODULES) {
236
+ reportDiagnostic?.({
237
+ code: 'project-model-module-limit',
238
+ message: `项目模型只分析前 ${MAX_MODULES} 个模块;其余模块当前未生成知识记录。`,
239
+ });
240
+ }
241
+ const bounded = unique.slice(0, MAX_MODULES);
242
+ const slugs = bounded.map(normalizedModuleSlug);
243
+ const duplicateSlugs = new Set(slugs.filter((slug, index, all) => all.indexOf(slug) !== all.lastIndexOf(slug)));
244
+ return bounded.map((modulePath) => ({
245
+ modulePath,
246
+ absolutePath: path.join(root, ...modulePath.split('/')),
247
+ id: moduleRecordId(modulePath, duplicateSlugs),
248
+ }));
249
+ }
250
+ export async function discoverExpectedProjectModelRecordIds(options) {
251
+ const deadline = Date.now() + MAX_EXTRACTION_MS;
252
+ try {
253
+ const modules = await discoverProjectModules(path.resolve(options.projectRoot), deadline, options.reportDiagnostic);
254
+ return ['generated-project-map', 'generated-build-test', ...modules.map((module) => module.id)];
255
+ }
256
+ catch (error) {
257
+ if (!(error instanceof ExtractionDeadlineExceeded))
258
+ throw error;
259
+ options.reportDiagnostic?.({
260
+ code: 'project-model-timeout',
261
+ message: '项目模型发现超过 1.5 秒预算,当前仅补齐已确认的记录。',
262
+ });
263
+ return ['generated-project-map', 'generated-build-test'];
264
+ }
265
+ }
266
+ function isEntrypoint(relativePath) {
267
+ const stem = path.posix
268
+ .basename(relativePath, path.posix.extname(relativePath))
269
+ .toLocaleLowerCase();
270
+ return /^(?:index|main|cli)$/u.test(stem) || /-entry$/u.test(stem);
271
+ }
272
+ function extractImportSpecifiers(text) {
273
+ const values = [
274
+ ...text.matchAll(/\b(?:import|export)\s+(?:[^;]*?\s+from\s+)?['"]([^'"]+)['"]/gu),
275
+ ...text.matchAll(/\b(?:require|import)\s*\(\s*['"]([^'"]+)['"]\s*\)/gu),
276
+ ].flatMap((match) => (match[1] ? [match[1]] : []));
277
+ return [...new Set(values)].slice(0, 32);
278
+ }
279
+ function resolveImportedModule(root, importer, specifier, modules) {
280
+ if (!specifier.startsWith('.'))
281
+ return undefined;
282
+ const absolute = path.resolve(path.dirname(path.join(root, ...importer.split('/'))), specifier);
283
+ return modules.find((module) => absolute === module.absolutePath || absolute.startsWith(`${module.absolutePath}${path.sep}`));
284
+ }
285
+ async function moduleRecords(root, deadline, language, preferredRecordIds, reportDiagnostic) {
286
+ const modules = await discoverProjectModules(root, deadline, reportDiagnostic);
287
+ const preference = new Map((preferredRecordIds ?? []).map((id, index) => [id, index]));
288
+ const scanOrder = [...modules].sort((left, right) => {
289
+ const leftPreference = preference.get(left.id) ?? Number.POSITIVE_INFINITY;
290
+ const rightPreference = preference.get(right.id) ?? Number.POSITIVE_INFINITY;
291
+ return leftPreference - rightPreference || left.modulePath.localeCompare(right.modulePath);
292
+ });
293
+ const discoveredCodeFiles = [];
294
+ const scannedModuleIds = new Set();
295
+ let timedOut = false;
296
+ for (const module of scanOrder) {
297
+ if (discoveredCodeFiles.length > MAX_SOURCE_FILES)
298
+ break;
299
+ if (Date.now() > deadline) {
300
+ timedOut = true;
301
+ break;
302
+ }
303
+ const files = await realProjectFiles(module.absolutePath, MAX_SOURCE_FILES + 1 - discoveredCodeFiles.length, deadline, (file) => CODE_EXTENSIONS.has(path.extname(file).toLocaleLowerCase()), true);
304
+ scannedModuleIds.add(module.id);
305
+ discoveredCodeFiles.push(...files);
306
+ if (Date.now() > deadline) {
307
+ timedOut = true;
308
+ break;
309
+ }
310
+ }
311
+ const sourceLimitReached = discoveredCodeFiles.length > MAX_SOURCE_FILES;
312
+ if (sourceLimitReached) {
313
+ reportDiagnostic?.({
314
+ code: 'project-model-source-limit',
315
+ message: `项目模型只分析前 ${MAX_SOURCE_FILES} 个源码文件;其余源码当前未用于生成模块记录。`,
316
+ });
317
+ }
318
+ const codeFiles = discoveredCodeFiles
319
+ .slice(0, MAX_SOURCE_FILES)
320
+ .sort((left, right) => relative(root, left).localeCompare(relative(root, right)));
321
+ const imports = [];
322
+ const registrations = new Map();
323
+ const sourceTexts = await Promise.all(codeFiles.map(async (file) => {
324
+ if (Date.now() > deadline)
325
+ return { file, text: null };
326
+ return { file, text: await readText(root, relative(root, file), deadline) };
327
+ }));
328
+ if (Date.now() > deadline)
329
+ timedOut = true;
330
+ for (const { file, text } of sourceTexts) {
331
+ if (!TS_JS_EXTENSIONS.has(path.extname(file).toLocaleLowerCase()))
225
332
  continue;
226
- const imports = [
227
- ...text.matchAll(/\b(?:import|export)\s+(?:[^;]*?\s+from\s+)?['"]([^'"]+)['"]/gu),
333
+ const importer = relative(root, file);
334
+ if (text === null)
335
+ continue;
336
+ for (const specifier of extractImportSpecifiers(text)) {
337
+ imports.push({
338
+ importer,
339
+ specifier,
340
+ targetModule: resolveImportedModule(root, importer, specifier, modules),
341
+ });
342
+ }
343
+ const names = [...text.matchAll(/\b(register[A-Z][A-Za-z0-9_$]*)\s*\(/gu)].flatMap((match) => match[1] ? [match[1]] : []);
344
+ if (names.length > 0)
345
+ registrations.set(importer, [...new Set(names)].slice(0, 6));
346
+ }
347
+ if (timedOut) {
348
+ reportDiagnostic?.({
349
+ code: 'project-model-timeout',
350
+ message: '项目模型生成超过 1.5 秒预算,当前仅保留预算内已确认的记录。',
351
+ });
352
+ }
353
+ const records = [];
354
+ for (const module of modules) {
355
+ if (!scannedModuleIds.has(module.id))
356
+ continue;
357
+ if ((timedOut || sourceLimitReached) &&
358
+ preferredRecordIds !== undefined &&
359
+ !preference.has(module.id))
360
+ continue;
361
+ const moduleFiles = codeFiles.filter((file) => file === module.absolutePath || file.startsWith(`${module.absolutePath}${path.sep}`));
362
+ const entrypoints = moduleFiles
363
+ .map((file) => relative(root, file))
364
+ .filter(isEntrypoint)
365
+ .sort((left, right) => left.localeCompare(right))
366
+ .slice(0, 8);
367
+ const outgoing = imports.filter((entry) => entry.importer.startsWith(`${module.modulePath}/`) &&
368
+ entry.targetModule !== undefined &&
369
+ entry.targetModule.modulePath !== module.modulePath);
370
+ const dependencyModules = [
371
+ ...new Map(outgoing.map((entry) => [entry.targetModule.id, entry.targetModule])).values(),
228
372
  ]
229
- .map((match) => match[1])
230
- .slice(0, 4);
231
- if (imports.length > 0)
232
- evidence.push(language === 'en'
233
- ? `${relative(root, file)} imports ${imports.join(', ')}`
234
- : `${relative(root, file)} 引用 ${imports.join('、')}`);
235
- if (/\bregister[A-Z][A-Za-z0-9_$]*\s*\(/u.test(text)) {
236
- registrationSources.push(source(relative(root, file)));
373
+ .sort((left, right) => left.modulePath.localeCompare(right.modulePath))
374
+ .slice(0, 8);
375
+ const inbound = imports.filter((entry) => entry.targetModule?.modulePath === module.modulePath &&
376
+ !entry.importer.startsWith(`${module.modulePath}/`));
377
+ const callerModules = [
378
+ ...new Set(inbound.map((entry) => modules.find((candidate) => entry.importer.startsWith(`${candidate.modulePath}/`))
379
+ ?.modulePath ?? entry.importer)),
380
+ ]
381
+ .sort((left, right) => left.localeCompare(right))
382
+ .slice(0, 8);
383
+ const registrationEntries = [...registrations.entries()]
384
+ .filter(([file]) => file.startsWith(`${module.modulePath}/`))
385
+ .sort(([left], [right]) => left.localeCompare(right))
386
+ .slice(0, 6);
387
+ const testPath = `test/${module.modulePath}`;
388
+ const hasTestMirror = await pathIsDirectory(path.join(root, ...testPath.split('/')));
389
+ if (entrypoints.length === 0 &&
390
+ dependencyModules.length === 0 &&
391
+ callerModules.length === 0 &&
392
+ registrationEntries.length === 0 &&
393
+ !hasTestMirror)
394
+ continue;
395
+ const conclusions = [];
396
+ if (entrypoints.length > 0) {
397
+ conclusions.push({
398
+ text: language === 'en'
399
+ ? `Confirmed entry points: ${entrypoints.join(', ')}.`
400
+ : `可确认入口:${entrypoints.join('、')}。`,
401
+ sources: entrypoints.map((entry) => source(entry)),
402
+ });
403
+ }
404
+ if (dependencyModules.length > 0) {
405
+ conclusions.push({
406
+ text: language === 'en'
407
+ ? `Cross-module dependencies: ${dependencyModules.map((entry) => entry.modulePath).join(', ')}.`
408
+ : `跨模块依赖:${dependencyModules.map((entry) => entry.modulePath).join('、')}。`,
409
+ sources: outgoing.slice(0, 16).map((entry) => source(entry.importer)),
410
+ });
237
411
  }
412
+ if (callerModules.length > 0) {
413
+ conclusions.push({
414
+ text: language === 'en'
415
+ ? `External callers: ${callerModules.join(', ')}.`
416
+ : `外部调用方:${callerModules.join('、')}。`,
417
+ sources: inbound.slice(0, 16).map((entry) => source(entry.importer)),
418
+ });
419
+ }
420
+ if (registrationEntries.length > 0) {
421
+ conclusions.push({
422
+ text: language === 'en'
423
+ ? `Registration points: ${registrationEntries.map(([file, names]) => `${file} (${names.join(', ')})`).join('; ')}.`
424
+ : `注册点:${registrationEntries.map(([file, names]) => `${file}(${names.join('、')})`).join(';')}。`,
425
+ sources: registrationEntries.map(([file]) => source(file)),
426
+ });
427
+ }
428
+ if (hasTestMirror) {
429
+ const testFiles = await realProjectFiles(path.join(root, ...testPath.split('/')), 4, deadline, () => true, true);
430
+ conclusions.push({
431
+ text: language === 'en'
432
+ ? `Mirrored test directory: ${testPath}/.`
433
+ : `镜像测试目录:${testPath}/。`,
434
+ sources: testFiles.map((file) => source(relative(root, file))),
435
+ });
436
+ }
437
+ const relations = dependencyModules.map((dependency) => {
438
+ const evidence = outgoing.find((entry) => entry.targetModule?.id === dependency.id);
439
+ return { type: 'depends-on', targetId: dependency.id, sources: [source(evidence.importer)] };
440
+ });
441
+ records.push(recordBase(module.id, 'dependency', language === 'en'
442
+ ? `Module entry points and dependencies: ${module.modulePath}`
443
+ : `模块入口与依赖:${module.modulePath}`, conclusions.map((entry) => entry.text).join(' '), conclusions, {
444
+ applicablePaths: [`${module.modulePath}/`, ...(hasTestMirror ? [`${testPath}/`] : [])],
445
+ relations,
446
+ }));
238
447
  }
239
- return recordBase('generated-module-overview', 'dependency', language === 'en' ? 'Module responsibilities and dependencies' : '模块职责与依赖概览', language === 'en'
240
- ? 'Module boundaries derived from bounded import/export relationships without indexing complete source files.'
241
- : '从有限源码文件的 import/export 关系生成模块边界提示,不索引完整源码正文。', [
242
- {
243
- text: language === 'en'
244
- ? `Recognized modules: ${relationTargets || 'inspect the repository layout first'}.${evidence.length > 0 ? ` ${evidence.join('; ')}` : ''}`
245
- : `当前可识别模块:${relationTargets || '请先核对仓库布局'}。${evidence.length > 0 ? ` ${evidence.join(';')}` : ''}`,
246
- sources: sourceRefs,
247
- },
248
- ], {
249
- applicablePaths: names.map((name) => `${name}/`),
250
- relations: [
251
- ...(sourceRefs.length > 0
252
- ? [
253
- {
254
- type: 'depends-on',
255
- targetId: 'generated-project-map',
256
- sources: sourceRefs.slice(0, 1),
257
- },
258
- ]
259
- : []),
260
- ...(registrationSources.length > 0
261
- ? [
262
- {
263
- type: 'registers',
264
- targetId: 'generated-project-map',
265
- sources: registrationSources.slice(0, 2),
266
- },
267
- ]
268
- : []),
269
- ],
270
- });
448
+ return records;
449
+ }
450
+ async function packageManager(root, manifestText) {
451
+ try {
452
+ const declared = JSON.parse(manifestText).packageManager;
453
+ if (typeof declared === 'string' && declared.trim()) {
454
+ const name = declared.trim().split('@')[0];
455
+ if (name && ['pnpm', 'npm', 'yarn', 'bun'].includes(name))
456
+ return name;
457
+ }
458
+ }
459
+ catch {
460
+ // The manifest parser below will report no commands.
461
+ }
462
+ for (const [lockfile, manager] of [
463
+ ['pnpm-lock.yaml', 'pnpm'],
464
+ ['yarn.lock', 'yarn'],
465
+ ['bun.lockb', 'bun'],
466
+ ['bun.lock', 'bun'],
467
+ ['package-lock.json', 'npm'],
468
+ ]) {
469
+ try {
470
+ const stat = await fs.lstat(path.join(root, lockfile));
471
+ if (stat.isFile())
472
+ return manager;
473
+ }
474
+ catch {
475
+ // Continue with the next declared lockfile.
476
+ }
477
+ }
478
+ return 'npm';
271
479
  }
272
- async function buildTestRecord(root, deadline, language = 'zh-CN') {
480
+ async function buildTestRecord(root, deadline, language) {
273
481
  const manifestSource = await firstExistingSource(root, ['package.json', 'pyproject.toml', 'Makefile', 'README.md'], deadline);
274
482
  const manifestText = manifestSource ? await readText(root, manifestSource, deadline) : null;
275
483
  const commands = [];
276
484
  if (manifestSource === 'package.json' && manifestText) {
277
485
  try {
278
486
  const scripts = JSON.parse(manifestText).scripts ?? {};
487
+ const manager = await packageManager(root, manifestText);
279
488
  for (const name of ['build', 'test', 'lint', 'typecheck', 'check:generated']) {
280
489
  if (typeof scripts[name] === 'string')
281
- commands.push(`pnpm run ${name}`);
490
+ commands.push(`${manager} run ${name}`);
282
491
  }
283
492
  }
284
493
  catch {
285
- // An invalid manifest remains a source diagnostic for later validation.
494
+ // An invalid manifest remains visible as evidence for later validation.
286
495
  }
287
496
  }
288
- const references = [source(manifestSource ?? 'README.md')];
497
+ const references = manifestSource ? [source(manifestSource)] : [];
498
+ if (references.length === 0)
499
+ return null;
289
500
  const summary = commands.length > 0
290
501
  ? language === 'en'
291
502
  ? `Preferred project verification commands: ${commands.join(', ')}.`
292
503
  : `项目验证优先使用:${commands.join('、')}。`
293
504
  : language === 'en'
294
- ? 'No build or test command is directly discoverable from the manifest; inspect the project documentation before choosing verification.'
295
- : '项目未声明可从 manifest 直接识别的构建或测试命令,Agent 应先读取项目说明再选择验证方式。';
505
+ ? 'No build or test command is directly discoverable from the manifest.'
506
+ : '项目未声明可从 manifest 直接识别的构建或测试命令。';
296
507
  return recordBase('generated-build-test', 'procedure', language === 'en' ? 'Build and test workflow' : '构建与测试方式', summary, [
297
508
  {
298
509
  text: commands.length > 0
@@ -300,8 +511,8 @@ async function buildTestRecord(root, deadline, language = 'zh-CN') {
300
511
  ? `Run in order: ${commands.join(', ')}.`
301
512
  : `建议按顺序运行:${commands.join('、')}。`
302
513
  : language === 'en'
303
- ? 'Inspect README, project configuration, and CI for the actual verification commands.'
304
- : '请先核对 README、项目配置和 CI 中记录的实际验证命令。',
514
+ ? 'Inspect project documentation and CI before choosing verification commands.'
515
+ : '请先核对项目说明和 CI 中记录的实际验证命令。',
305
516
  sources: references,
306
517
  },
307
518
  ], {
@@ -312,41 +523,27 @@ async function buildTestRecord(root, deadline, language = 'zh-CN') {
312
523
  })),
313
524
  });
314
525
  }
315
- function knowledgeCorpusRecord(sources, language = 'zh-CN') {
316
- const normalized = [
317
- ...new Set(sources
318
- .map((entry) => entry.replaceAll('\\', '/').replace(/^\.\//u, '').trim())
319
- .filter(Boolean)),
320
- ].slice(0, 24);
321
- if (normalized.length === 0)
322
- return null;
323
- const references = normalized.map((entry) => source(entry));
324
- return recordBase('generated-knowledge-corpus', 'fact', language === 'en' ? 'Project knowledge document sources' : '项目知识文档来源', language === 'en'
325
- ? 'Traceable knowledge sources derived from built-in project documents and user-configured Markdown paths.'
326
- : '从项目内置文档和用户配置的 Markdown 路径生成的可核对知识来源。', [
327
- {
328
- text: language === 'en'
329
- ? `Current project knowledge documents: ${normalized.join(', ')}.`
330
- : `当前项目知识文档:${normalized.join('、')}。`,
331
- sources: references,
332
- },
333
- ]);
334
- }
335
526
  async function extractDraftRecords(options) {
336
527
  const root = path.resolve(options.projectRoot);
337
528
  const deadline = Date.now() + MAX_EXTRACTION_MS;
529
+ const language = options.language ?? 'zh-CN';
338
530
  const records = [];
339
531
  try {
340
- records.push(await projectMapRecord(root, deadline, options.changedPaths, options.language ?? 'zh-CN'));
341
- records.push(await moduleOverviewRecord(root, deadline, options.changedPaths, options.language ?? 'zh-CN'));
342
- records.push(await buildTestRecord(root, deadline, options.language ?? 'zh-CN'));
343
- const corpus = knowledgeCorpusRecord(options.knowledgeSources ?? [], options.language);
344
- if (corpus !== null)
345
- records.push(corpus);
532
+ const projectMap = await projectMapRecord(root, deadline, language);
533
+ if (projectMap)
534
+ records.push(projectMap);
535
+ const buildTest = await buildTestRecord(root, deadline, language);
536
+ if (buildTest)
537
+ records.push(buildTest);
538
+ records.push(...(await moduleRecords(root, deadline, language, options.preferredRecordIds, options.reportDiagnostic)));
346
539
  }
347
540
  catch (error) {
348
541
  if (!(error instanceof ExtractionDeadlineExceeded))
349
542
  throw error;
543
+ options.reportDiagnostic?.({
544
+ code: 'project-model-timeout',
545
+ message: '项目模型生成超过 1.5 秒预算,当前仅保留预算内已确认的记录。',
546
+ });
350
547
  }
351
548
  return records;
352
549
  }
@@ -355,18 +552,18 @@ async function sourceVersions(root, sources) {
355
552
  const versions = [];
356
553
  for (const relativePath of unique.slice(0, 32)) {
357
554
  try {
358
- const inspected = await fs.lstat(path.join(root, ...relativePath.split('/')));
359
- if (!inspected.isFile() || inspected.isSymbolicLink())
360
- continue;
555
+ const hashed = await hashProtectedProjectFile(root, relativePath, {
556
+ label: `Project Knowledge source ${relativePath}`,
557
+ });
361
558
  versions.push({
362
559
  source: relativePath,
363
- size: inspected.size,
364
- modifiedAt: Math.trunc(inspected.mtimeMs),
560
+ size: Number(hashed.stat.size),
561
+ modifiedAt: Math.trunc(Number(hashed.stat.mtimeMs)),
562
+ digest: hashed.digest,
365
563
  });
366
564
  }
367
565
  catch {
368
- // The candidate is still bounded; current-source validation will reject
369
- // it if a referenced file disappeared before persistence.
566
+ // Current-source validation will reject a source that disappeared before persistence.
370
567
  }
371
568
  }
372
569
  return versions;