@rpamis/comet 0.4.0-beta.18 → 0.4.0-beta.19

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 (241) hide show
  1. package/README.md +18 -3
  2. package/assets/manifest.json +3 -1
  3. package/assets/skills/comet/scripts/comet-archive.mjs +121 -121
  4. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +84 -84
  5. package/assets/skills/comet/scripts/comet-guard.mjs +152 -152
  6. package/assets/skills/comet/scripts/comet-handoff.mjs +123 -123
  7. package/assets/skills/comet/scripts/comet-hook-guard.mjs +75 -75
  8. package/assets/skills/comet/scripts/comet-hook-router.mjs +91 -91
  9. package/assets/skills/comet/scripts/comet-intent.mjs +6 -6
  10. package/assets/skills/comet/scripts/comet-resume-probe.mjs +79 -79
  11. package/assets/skills/comet/scripts/comet-runtime.mjs +169 -169
  12. package/assets/skills/comet/scripts/comet-state.mjs +88 -88
  13. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +97 -97
  14. package/assets/skills/comet-build/SKILL.md +21 -6
  15. package/assets/skills/comet-design/SKILL.md +2 -2
  16. package/assets/skills/comet-native/SKILL.md +7 -7
  17. package/assets/skills/comet-native/reference/artifacts.md +3 -3
  18. package/assets/skills/comet-native/reference/clarification.md +1 -1
  19. package/assets/skills/comet-native/reference/commands.md +3 -3
  20. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +114 -113
  21. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +123 -123
  22. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +88 -88
  23. package/assets/skills/comet-native/scripts/comet-native-init.mjs +116 -116
  24. package/assets/skills/comet-native/scripts/comet-native-new.mjs +100 -100
  25. package/assets/skills/comet-native/scripts/comet-native-next.mjs +118 -118
  26. package/assets/skills/comet-native/scripts/comet-native-root.mjs +95 -95
  27. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +145 -144
  28. package/assets/skills/comet-native/scripts/comet-native-select.mjs +101 -101
  29. package/assets/skills/comet-native/scripts/comet-native-show.mjs +83 -83
  30. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +87 -87
  31. package/assets/skills/comet-native/scripts/comet-native-status.mjs +98 -98
  32. package/assets/skills/comet-review/SKILL.md +121 -0
  33. package/assets/skills/comet-review/agents/openai.yaml +5 -0
  34. package/assets/skills-zh/comet-build/SKILL.md +21 -6
  35. package/assets/skills-zh/comet-design/SKILL.md +2 -2
  36. package/assets/skills-zh/comet-native/SKILL.md +7 -7
  37. package/assets/skills-zh/comet-native/reference/artifacts.md +3 -3
  38. package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
  39. package/assets/skills-zh/comet-native/reference/commands.md +3 -3
  40. package/assets/skills-zh/comet-review/SKILL.md +121 -0
  41. package/assets/skills-zh/comet-review/agents/openai.yaml +5 -0
  42. package/dist/app/commands/init.d.ts.map +1 -1
  43. package/dist/app/commands/init.js +5 -9
  44. package/dist/app/commands/init.js.map +1 -1
  45. package/dist/app/commands/update.d.ts.map +1 -1
  46. package/dist/app/commands/update.js +5 -9
  47. package/dist/app/commands/update.js.map +1 -1
  48. package/dist/domains/comet-classic/classic-command-context.d.ts +9 -0
  49. package/dist/domains/comet-classic/classic-command-context.d.ts.map +1 -1
  50. package/dist/domains/comet-classic/classic-command-context.js +10 -0
  51. package/dist/domains/comet-classic/classic-command-context.js.map +1 -1
  52. package/dist/domains/comet-classic/classic-guard.d.ts.map +1 -1
  53. package/dist/domains/comet-classic/classic-guard.js +2 -2
  54. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  55. package/dist/domains/comet-classic/classic-handoff.d.ts.map +1 -1
  56. package/dist/domains/comet-classic/classic-handoff.js +44 -6
  57. package/dist/domains/comet-classic/classic-handoff.js.map +1 -1
  58. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  59. package/dist/domains/comet-classic/classic-hook-guard.js +2 -1
  60. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  61. package/dist/domains/comet-classic/classic-intent-command.d.ts.map +1 -1
  62. package/dist/domains/comet-classic/classic-intent-command.js +2 -1
  63. package/dist/domains/comet-classic/classic-intent-command.js.map +1 -1
  64. package/dist/domains/comet-classic/classic-resume-probe-command.d.ts.map +1 -1
  65. package/dist/domains/comet-classic/classic-resume-probe-command.js +4 -3
  66. package/dist/domains/comet-classic/classic-resume-probe-command.js.map +1 -1
  67. package/dist/domains/comet-classic/classic-runtime-run.d.ts +6 -0
  68. package/dist/domains/comet-classic/classic-runtime-run.d.ts.map +1 -1
  69. package/dist/domains/comet-classic/classic-runtime-run.js +58 -9
  70. package/dist/domains/comet-classic/classic-runtime-run.js.map +1 -1
  71. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  72. package/dist/domains/comet-classic/classic-state-command.js +8 -5
  73. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  74. package/dist/domains/comet-classic/classic-validate-command.d.ts.map +1 -1
  75. package/dist/domains/comet-classic/classic-validate-command.js +2 -2
  76. package/dist/domains/comet-classic/classic-validate-command.js.map +1 -1
  77. package/dist/domains/comet-classic/classic-workspace-command.d.ts.map +1 -1
  78. package/dist/domains/comet-classic/classic-workspace-command.js +3 -3
  79. package/dist/domains/comet-classic/classic-workspace-command.js.map +1 -1
  80. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  81. package/dist/domains/comet-entry/hook-adapter.js +4 -1
  82. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  83. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  84. package/dist/domains/comet-native/native-archive-command.js +2 -0
  85. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  86. package/dist/domains/comet-native/native-atomic-file.d.ts.map +1 -1
  87. package/dist/domains/comet-native/native-atomic-file.js +17 -10
  88. package/dist/domains/comet-native/native-atomic-file.js.map +1 -1
  89. package/dist/domains/comet-native/native-children.d.ts +18 -2
  90. package/dist/domains/comet-native/native-children.d.ts.map +1 -1
  91. package/dist/domains/comet-native/native-children.js +73 -8
  92. package/dist/domains/comet-native/native-children.js.map +1 -1
  93. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -1
  94. package/dist/domains/comet-native/native-cli-help.js +10 -4
  95. package/dist/domains/comet-native/native-cli-help.js.map +1 -1
  96. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  97. package/dist/domains/comet-native/native-cli-shared.js +18 -5
  98. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  99. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  100. package/dist/domains/comet-native/native-hook-guard.js +15 -2
  101. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  102. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  103. package/dist/domains/comet-native/native-next-command.js +94 -15
  104. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  105. package/dist/domains/comet-native/native-portable-continuation.d.ts +19 -7
  106. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -1
  107. package/dist/domains/comet-native/native-portable-continuation.js +115 -72
  108. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -1
  109. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts.map +1 -1
  110. package/dist/domains/comet-native/native-portable-migration-runtime.js +9 -4
  111. package/dist/domains/comet-native/native-portable-migration-runtime.js.map +1 -1
  112. package/dist/domains/comet-native/native-portable-runtime.d.ts +14 -1
  113. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -1
  114. package/dist/domains/comet-native/native-portable-runtime.js +59 -1
  115. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -1
  116. package/dist/domains/comet-native/native-pull-request-finish.d.ts +35 -0
  117. package/dist/domains/comet-native/native-pull-request-finish.d.ts.map +1 -0
  118. package/dist/domains/comet-native/native-pull-request-finish.js +282 -0
  119. package/dist/domains/comet-native/native-pull-request-finish.js.map +1 -0
  120. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -1
  121. package/dist/domains/comet-native/native-status-discovery.js +24 -6
  122. package/dist/domains/comet-native/native-status-discovery.js.map +1 -1
  123. package/dist/domains/comet-native/native-workspace-finish.d.ts +6 -0
  124. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -1
  125. package/dist/domains/comet-native/native-workspace-finish.js +86 -35
  126. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -1
  127. package/dist/domains/dashboard/web/assets/{abnfDiagram-N423BO3Z-B5cFR6hS.js → abnfDiagram-N423BO3Z-BYya6ofk.js} +1 -1
  128. package/dist/domains/dashboard/web/assets/{arc-CVQDtMsu.js → arc-DJbo4TD3.js} +1 -1
  129. package/dist/domains/dashboard/web/assets/{architectureDiagram-T3A2C74G-C0v0kULK.js → architectureDiagram-T3A2C74G-D8uZ2IB-.js} +1 -1
  130. package/dist/domains/dashboard/web/assets/{blockDiagram-VBNYF7ZC-DpHLuxu4.js → blockDiagram-VBNYF7ZC-B16BVj-r.js} +1 -1
  131. package/dist/domains/dashboard/web/assets/{c4Diagram-5PPSVZJV-BHnFxUs1.js → c4Diagram-5PPSVZJV-ayV208_D.js} +1 -1
  132. package/dist/domains/dashboard/web/assets/channel-CEsrvmig.js +1 -0
  133. package/dist/domains/dashboard/web/assets/{chunk-2GRJ4B5K-CGC9gh5n.js → chunk-2GRJ4B5K-Bn5o8p3H.js} +1 -1
  134. package/dist/domains/dashboard/web/assets/{chunk-2Q5K7J3B-l4puLU_O.js → chunk-2Q5K7J3B-BnF1SI6B.js} +1 -1
  135. package/dist/domains/dashboard/web/assets/{chunk-5RXB4S5H-ls9jQHZc.js → chunk-5RXB4S5H-ETnma053.js} +1 -1
  136. package/dist/domains/dashboard/web/assets/{chunk-5VM5RSS4-BVavmTEq.js → chunk-5VM5RSS4-Cuvy639H.js} +1 -1
  137. package/dist/domains/dashboard/web/assets/{chunk-6Q2QTUOP-Dungt2g9.js → chunk-6Q2QTUOP-DOXBzl73.js} +1 -1
  138. package/dist/domains/dashboard/web/assets/{chunk-GF5L2VYU-BidXO_ZP.js → chunk-GF5L2VYU-CfREXlEl.js} +1 -1
  139. package/dist/domains/dashboard/web/assets/{chunk-JWPE2WC7-57L5Up5X.js → chunk-JWPE2WC7-DWIdpYTb.js} +1 -1
  140. package/dist/domains/dashboard/web/assets/{chunk-KBJHAD2P-C5u5vbwr.js → chunk-KBJHAD2P-BnqPcfZB.js} +1 -1
  141. package/dist/domains/dashboard/web/assets/{chunk-RYQCIY6F-CvLz21I2.js → chunk-RYQCIY6F-DdJ00fZz.js} +1 -1
  142. package/dist/domains/dashboard/web/assets/{chunk-XXDRQBXY-D5nJpckG.js → chunk-XXDRQBXY-BVDhdJyW.js} +1 -1
  143. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-CKFe0hg4.js +1 -0
  144. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-CKFe0hg4.js +1 -0
  145. package/dist/domains/dashboard/web/assets/{cose-bilkent-JH36ORCC-Dp0JAGyE.js → cose-bilkent-JH36ORCC-C-nglwHC.js} +1 -1
  146. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-EjC54l1g.js → cynefin-VYW2F7L2-C8TMmrbP.js} +1 -1
  147. package/dist/domains/dashboard/web/assets/{cynefinDiagram-MW4NZA55-CpYrW3w3.js → cynefinDiagram-MW4NZA55-C3pnQnjg.js} +1 -1
  148. package/dist/domains/dashboard/web/assets/{dagre-VZM6K2ZE-h5K39rCk.js → dagre-VZM6K2ZE-DY7UWiPI.js} +1 -1
  149. package/dist/domains/dashboard/web/assets/{diagram-7IWD3JNH-CKQj9O4H.js → diagram-7IWD3JNH-voTyDkQ5.js} +1 -1
  150. package/dist/domains/dashboard/web/assets/{diagram-B4RE2ZJO-DXRIYcnW.js → diagram-B4RE2ZJO-B3VkUMck.js} +1 -1
  151. package/dist/domains/dashboard/web/assets/{diagram-LBJQPF4R-wWutQYmv.js → diagram-LBJQPF4R-BdJzPkv8.js} +1 -1
  152. package/dist/domains/dashboard/web/assets/{diagram-Q27KOJAE-EgXLJQYi.js → diagram-Q27KOJAE-Bsq0anZx.js} +1 -1
  153. package/dist/domains/dashboard/web/assets/{diagram-UB23O5K3-CsQRXDQZ.js → diagram-UB23O5K3-CBaKRbcu.js} +1 -1
  154. package/dist/domains/dashboard/web/assets/{ebnfDiagram-BXEA7PRR-gm328Eho.js → ebnfDiagram-BXEA7PRR-Bl9Bm5wa.js} +1 -1
  155. package/dist/domains/dashboard/web/assets/{erDiagram-JOGREHBK-BbbMVUx_.js → erDiagram-JOGREHBK-DjOZzfKI.js} +1 -1
  156. package/dist/domains/dashboard/web/assets/{flowDiagram-UKHOOZJN-1Y7scCns.js → flowDiagram-UKHOOZJN-C21e4siK.js} +1 -1
  157. package/dist/domains/dashboard/web/assets/{ganttDiagram-PKOTCBZU-BAoBqczv.js → ganttDiagram-PKOTCBZU-Bs62uy6-.js} +1 -1
  158. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-DS77QQ5N-CMUAyEzl.js → gitGraphDiagram-DS77QQ5N-DQY_Ba00.js} +1 -1
  159. package/dist/domains/dashboard/web/assets/{index-CCApJ0Yr.js → index-BLv71GRj.js} +1 -1
  160. package/dist/domains/dashboard/web/assets/{index-DWdm_XBi.js → index-Be4r99N4.js} +3 -3
  161. package/dist/domains/dashboard/web/assets/index-ByVYiA6g.css +1 -0
  162. package/dist/domains/dashboard/web/assets/{infoDiagram-6WML65LV-BaCdtYYC.js → infoDiagram-6WML65LV-CNgNNG9l.js} +1 -1
  163. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-WSZJBQD7-DQQlNnjU.js → ishikawaDiagram-WSZJBQD7-D9k1fTO1.js} +1 -1
  164. package/dist/domains/dashboard/web/assets/{journeyDiagram-NVQOT4AX-DW9wUMqn.js → journeyDiagram-NVQOT4AX-CHijUnPl.js} +1 -1
  165. package/dist/domains/dashboard/web/assets/{kanban-definition-27J2QSJJ-C_ITaZ0q.js → kanban-definition-27J2QSJJ-DfWlntDq.js} +1 -1
  166. package/dist/domains/dashboard/web/assets/{linear-DXOo6ZRT.js → linear-o6hemX-z.js} +1 -1
  167. package/dist/domains/dashboard/web/assets/{mermaid.core-ol-0NI97.js → mermaid.core-B1DoOsPD.js} +4 -4
  168. package/dist/domains/dashboard/web/assets/{mindmap-definition-FAOFIHXS-CHF_HOLV.js → mindmap-definition-FAOFIHXS-COMQF9Yy.js} +1 -1
  169. package/dist/domains/dashboard/web/assets/{pegDiagram-VL7TDLO6-wQEvkNF8.js → pegDiagram-VL7TDLO6-C_21n7Ps.js} +1 -1
  170. package/dist/domains/dashboard/web/assets/{pieDiagram-7S7Q4E2Y-C3H3kiIP.js → pieDiagram-7S7Q4E2Y-D3EmoYDY.js} +1 -1
  171. package/dist/domains/dashboard/web/assets/{quadrantDiagram-CIZ2JOQS-S0FdVzJb.js → quadrantDiagram-CIZ2JOQS-C3fGdiMa.js} +1 -1
  172. package/dist/domains/dashboard/web/assets/{railroadDiagram-AXF67PYL-DCDXDaVg.js → railroadDiagram-AXF67PYL-mIsjemD-.js} +1 -1
  173. package/dist/domains/dashboard/web/assets/{requirementDiagram-LRYGKXZP-BW8J4gO_.js → requirementDiagram-LRYGKXZP-D_UMpS5e.js} +1 -1
  174. package/dist/domains/dashboard/web/assets/{sankeyDiagram-W5VNT64P-DQQBmLoy.js → sankeyDiagram-W5VNT64P-D1MwyMF6.js} +1 -1
  175. package/dist/domains/dashboard/web/assets/{sequenceDiagram-SI44F4Z6-2tDcli0Y.js → sequenceDiagram-SI44F4Z6-B8jp1RxX.js} +1 -1
  176. package/dist/domains/dashboard/web/assets/{sizeCapture-X5ZJPWSS-4sEZLBKb.js → sizeCapture-X5ZJPWSS-BKioI1Ql.js} +1 -1
  177. package/dist/domains/dashboard/web/assets/{stateDiagram-OKZ733FA-OgPb8pyR.js → stateDiagram-OKZ733FA-B7l8_CDo.js} +1 -1
  178. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-BIxuwbeV.js +1 -0
  179. package/dist/domains/dashboard/web/assets/{swimlanes-SLNWSIFB-DR7lwtxd.js → swimlanes-SLNWSIFB-951PRLYp.js} +2 -2
  180. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-CEo6cGsy.js +8 -0
  181. package/dist/domains/dashboard/web/assets/{timeline-definition-Z64GVDOM-DNIJVlQV.js → timeline-definition-Z64GVDOM-CeyA2KbI.js} +1 -1
  182. package/dist/domains/dashboard/web/assets/{vennDiagram-T6HMQDX7-CClhw4QZ.js → vennDiagram-T6HMQDX7-BHe0TZJV.js} +1 -1
  183. package/dist/domains/dashboard/web/assets/{wardleyDiagram-T6FBY63Y-DzR3aFPS.js → wardleyDiagram-T6FBY63Y-CWqdSzJ-.js} +1 -1
  184. package/dist/domains/dashboard/web/assets/{xychartDiagram-ELKLHX3M-DZhq0ZRj.js → xychartDiagram-ELKLHX3M-DCKiZVPV.js} +1 -1
  185. package/dist/domains/dashboard/web/index.html +2 -2
  186. package/dist/domains/dashboard/workspace.d.ts +3 -0
  187. package/dist/domains/dashboard/workspace.d.ts.map +1 -1
  188. package/dist/domains/dashboard/workspace.js +23 -2
  189. package/dist/domains/dashboard/workspace.js.map +1 -1
  190. package/dist/domains/integrations/openspec.d.ts +1 -1
  191. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  192. package/dist/domains/integrations/openspec.js +43 -84
  193. package/dist/domains/integrations/openspec.js.map +1 -1
  194. package/dist/domains/integrations/superpowers.d.ts +10 -1
  195. package/dist/domains/integrations/superpowers.d.ts.map +1 -1
  196. package/dist/domains/integrations/superpowers.js +73 -4
  197. package/dist/domains/integrations/superpowers.js.map +1 -1
  198. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  199. package/dist/domains/skill/platform-inspect.js +3 -3
  200. package/dist/domains/skill/platform-inspect.js.map +1 -1
  201. package/dist/domains/skill/platform-install.d.ts +3 -1
  202. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  203. package/dist/domains/skill/platform-install.js +15 -9
  204. package/dist/domains/skill/platform-install.js.map +1 -1
  205. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  206. package/dist/domains/skill/project-instructions.js +6 -0
  207. package/dist/domains/skill/project-instructions.js.map +1 -1
  208. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  209. package/dist/domains/skill/uninstall.js +39 -29
  210. package/dist/domains/skill/uninstall.js.map +1 -1
  211. package/dist/domains/workflow-contract/contained-atomic-write.d.ts.map +1 -1
  212. package/dist/domains/workflow-contract/contained-atomic-write.js +18 -10
  213. package/dist/domains/workflow-contract/contained-atomic-write.js.map +1 -1
  214. package/dist/domains/workflow-contract/project-config.d.ts +4 -2
  215. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  216. package/dist/domains/workflow-contract/project-config.js +132 -0
  217. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  218. package/dist/domains/workflow-contract/types.d.ts +9 -0
  219. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  220. package/dist/platform/fs/strip-bom.d.ts +10 -0
  221. package/dist/platform/fs/strip-bom.d.ts.map +1 -0
  222. package/dist/platform/fs/strip-bom.js +12 -0
  223. package/dist/platform/fs/strip-bom.js.map +1 -0
  224. package/dist/platform/install/platforms.d.ts +11 -0
  225. package/dist/platform/install/platforms.d.ts.map +1 -1
  226. package/dist/platform/install/platforms.js +36 -0
  227. package/dist/platform/install/platforms.js.map +1 -1
  228. package/dist/platform/process/external-command.d.ts +1 -0
  229. package/dist/platform/process/external-command.d.ts.map +1 -1
  230. package/dist/platform/process/external-command.js +2 -1
  231. package/dist/platform/process/external-command.js.map +1 -1
  232. package/eval/local/tests/conftest.py +18 -3
  233. package/eval/local/tests/scaffold/test_conftest_helpers.py +57 -0
  234. package/package.json +11 -26
  235. package/dist/domains/dashboard/web/assets/channel-eM0x3m1G.js +0 -1
  236. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-CEFhao2K.js +0 -1
  237. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-CEFhao2K.js +0 -1
  238. package/dist/domains/dashboard/web/assets/index-DhhbseFJ.css +0 -1
  239. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-CiDNPr4P.js +0 -1
  240. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-DggHFP9q.js +0 -8
  241. package/eval/local/tasks/comet-native-interrupted-transition/environment/.comet/config.yaml +0 -6
@@ -0,0 +1,121 @@
1
+ ---
2
+ name: comet-review
3
+ description: "Manually review the implementation diff for the current Comet change without advancing the workflow."
4
+ disable-model-invocation: true
5
+ ---
6
+
7
+ # Comet Manual Code Review
8
+
9
+ Run an on-demand, read-only code review for the currently selected Comet change. This entry is phase-neutral and does not replace Build or Verify validation and review.
10
+
11
+ This entry is independent of `review_mode`: `review_mode` controls the in-workflow automatic review policy, while `/comet-review` represents a single review manually triggered by the user. Invoking this entry must not read, modify, or override the current change's `review_mode`.
12
+
13
+ ## Invariants
14
+
15
+ The entire Skill invocation must remain read-only:
16
+
17
+ - Do not modify, create, or delete files.
18
+ - Do not stage, commit, switch branches, create branches, or create worktrees.
19
+ - Do not run `comet state select`, `comet native select`, `comet state set`, `comet state transition`, phase guards, `comet native next`, or archive commands.
20
+ - Do not fix findings, advance the phase, or update tasks, state, verification reports, or review records.
21
+ - Do not describe this review as a passing Verify result or treat “no findings” as proof that tests pass.
22
+
23
+ Only commands needed to read files, query status, and inspect Git diffs are allowed. Checks that may execute project code, install dependencies, or generate files are outside this entry's scope.
24
+
25
+ ## 1. Resolve the project and current change
26
+
27
+ 1. Use a read-only Git query to locate the project root. If the project is not a Git repository, use the current Comet project root.
28
+ 2. From the project root, run:
29
+
30
+ ```bash
31
+ comet status . --json
32
+ ```
33
+
34
+ 3. Read `.comet/current-change.json` and resolve the review target in this order:
35
+ - When it contains a valid `comet.selection.v2`, use its `workflow` and `change`.
36
+ - When selection is missing and status reports exactly one unarchived Comet change, use that change for this review only without writing a selection.
37
+ - When selection is missing and multiple changes exist, list their names, workflows, and phases, ask the user to choose one, and stop.
38
+ - When selection points to a missing, archived, or invalid change, report the stale or invalid selection and stop without repairing it.
39
+
40
+ Ignore unmanaged plain OpenSpec changes. Do not replace the selection with the default workflow when they differ.
41
+
42
+ ## 2. Collect review context
43
+
44
+ Read only the context needed for the current change, retaining a source path or command for every fact.
45
+
46
+ ### Classic
47
+
48
+ 1. Read and follow `comet-classic/reference/classic-layout.md` first to resolve the project's logical Classic roots.
49
+ 2. Read the current change's `proposal.md`, `design.md`, `tasks.md`, and `specs/*/spec.md`. Read the associated Design Doc when one exists.
50
+ 3. Use these read-only state queries to obtain the phase, baseline, and existing evidence references:
51
+
52
+ ```bash
53
+ comet state get <change-name> phase
54
+ comet state get <change-name> base_ref
55
+ comet state get <change-name> plan
56
+ comet state get <change-name> verification_report
57
+ ```
58
+
59
+ 4. Read the plan and verification report when present, plus build and verify command checks returned by `comet status . --json`. Label missing evidence as “not provided”; do not infer failure or success.
60
+
61
+ ### Native
62
+
63
+ Run these read-only commands:
64
+
65
+ ```bash
66
+ comet native show <change-name> --json
67
+ comet native status <change-name> --details --json
68
+ ```
69
+
70
+ Read the returned brief, complete proposed Specs, acceptance items, Builder handoff, checks, verification, risks, blockers, and verification report reference. Use evidence from the current candidate and iteration only. Historical iterations may explain residual risk but must not override current state.
71
+
72
+ ## 3. Establish the implementation diff
73
+
74
+ 1. Run `git status --short --untracked-files=all` first to fully enumerate staged, unstaged, and untracked worktree state.
75
+ 2. Use the current change's requirements, workspace binding, Git history, and worktree state to determine the most credible review scope related to the current change. For Classic, prefer a valid plan `base-ref`; when it is missing or invalid, fall back to the state `base_ref`. The two values do not need to match. Only when both values are invalid is the Classic baseline missing. For Native, treat the workspace relationship in state and the current candidate's implementation-scope evidence as inputs to this judgment.
76
+ 3. Inspect the complete diff from the trusted baseline to the current worktree, including committed, staged, and unstaged changes. Directly read all untracked files owned by the current change, including source, tests, documentation, configuration, and metadata (for example, `SKILL.md` and `agents/openai.yaml`), and label them as untracked.
77
+ 4. Exclude diffs clearly owned by another change or unrelated user work. Ask the user only when ambiguity would materially affect the review conclusions; otherwise continue from the available evidence and report the scope judgment and assumptions.
78
+
79
+ If the evidence above still does not yield a trusted, verifiable baseline, continue reviewing the visible worktree diff and prominently label the review scope as incomplete.
80
+
81
+ ## 4. Perform the review
82
+
83
+ Review requirements, tasks, and the current diff, focusing only on:
84
+
85
+ - implementation correctness and concrete logic defects;
86
+ - security, permission, and path-boundary risks;
87
+ - error handling, compatibility, and important edge cases;
88
+ - omitted tasks or implementation that contradicts explicit current-change requirements;
89
+ - whether tests cover the behavior change and whether existing evidence supports the stated conclusion.
90
+
91
+ Do not report style preferences, unrelated refactors, or speculation without a concrete impact as findings. Every finding must identify a file and line and explain the triggering behavior or risk. When evidence is insufficient, lower the severity or place the item under open questions.
92
+
93
+ Use only these severities:
94
+
95
+ - `CRITICAL`: security compromise, data loss, or an unusable core workflow;
96
+ - `IMPORTANT`: a concrete correctness defect, missing core acceptance behavior, or a high-probability regression;
97
+ - `WARNING`: a real but non-blocking edge risk or test gap;
98
+ - `SUGGESTION`: an improvement with a concrete benefit that does not affect current correctness.
99
+
100
+ ## 5. Report
101
+
102
+ Lead with findings ordered by severity. Use this format for every finding:
103
+
104
+ ```text
105
+ [IMPORTANT] Short title — path/to/file.ts:123
106
+ Impact: Which input or scenario produces which failure.
107
+ Evidence: The concrete relationship to the diff, task, specification, or recorded evidence.
108
+ ```
109
+
110
+ Then report:
111
+
112
+ - `Review scope`: workflow, change, phase, baseline, included diffs, and any scope limitations;
113
+ - `Evidence status`: test, build, and verification evidence read and its freshness, without rerunning tests;
114
+ - `Open questions`: only questions that genuinely block a conclusion;
115
+ - `Conclusion`: finding counts, or an explicit “No concrete findings.”
116
+
117
+ Even with no findings, state residual risks and checks that were not run. End with this fixed reminder:
118
+
119
+ > This is a read-only manual review. It does not advance the Comet phase and cannot replace `/comet-verify` or Native Verify.
120
+
121
+ If the user subsequently asks to fix a finding, treat that as a new write task, exit this Skill, and re-enter development through the repository's current workflow rules.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Comet Manual Code Review"
3
+ short_description: "Review the current change without advancing its workflow"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -34,17 +34,20 @@ comet state check <name> build
34
34
 
35
35
  通过 subagent 创建实施计划,避免 planning skill 占用主 session 上下文。计划文件和执行反馈必须使用 `comet state get <name> language` 读取到的 Comet 配置产物语言。
36
36
 
37
+ 派发前,主会话先确定完整计划路径 `docs/superpowers/plans/<YYYY-MM-DD>-<change-name>.md`(如 `docs/superpowers/plans/2026-08-21-rename-alert.md`),并在下方指令中原样传入。
38
+
37
39
  **Subagent 指令**:
38
40
 
39
41
  你是实施计划专家。基于以下输入创建实施计划:
40
42
 
41
- 1. **立即执行:** 使用 Skill 工具加载 Superpowers `writing-plans` 技能。禁止跳过此步骤。技能加载后,ARGUMENTS 必须包含:`Language: 使用 comet state get <name> language 读取到的 Comet 配置产物语言输出`
43
+ 1. **立即执行:** 使用 Skill 工具加载 Superpowers `writing-plans` 技能。禁止跳过此步骤。技能加载后,ARGUMENTS 必须包含:`Language: 使用 comet state get <name> language 读取到的 Comet 配置产物语言输出`。若 Skill 工具不可用或找不到该技能,立即结束,最终回复只写一行 `SKILL_UNAVAILABLE`,不要重试,也不要在没有技能的情况下自行写计划
42
44
  2. 读取 Design Doc(`docs/superpowers/specs/` 下的技术设计文档)
43
45
  3. 读取 `<classic-change-dir>/tasks.md`(任务边界)
44
- 4. 按技能指引创建计划
46
+ 4. 按技能指引创建计划;运行期间没有用户回答你,技能里向用户提问的步骤(如 `writing-plans` 结尾的 Execution Handoff)直接跳过,不要向用户提问
45
47
 
46
48
  计划要求:
47
- - 保存至 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
49
+ - 保存至指令中给定的计划路径,不更改文件名
50
+ - 只覆盖 tasks.md 列出的任务,不扩展范围
48
51
  - 引用设计文档,拆分为可执行任务
49
52
  - **Plan 文件头必须包含关联元数据**:
50
53
 
@@ -62,13 +65,17 @@ base-ref: <git rev-parse HEAD before implementation>
62
65
  git rev-parse HEAD
63
66
  ```
64
67
 
65
- 将计划写入文件后,返回文件路径。
68
+ 计划写入文件后,最终回复的最后一行固定为:
69
+
70
+ ```
71
+ PLAN_PATH: <计划文件的相对路径>
72
+ ```
66
73
 
67
74
  **执行 subagent**:将上述任务派发给 subagent。
68
75
 
69
76
  Subagent 完成后:
70
- - 若返回有效文件路径且文件存在,记录为 plan
71
- - 若 subagent 失败或返回路径无效,在主 session 内联加载 Superpowers `writing-plans` 技能创建计划(降级回退)
77
+ - 读取回复末尾的 `PLAN_PATH:` 行,文件存在即记录为 plan;没有该行时,再从回复文本中找已存在的有效路径
78
+ - 子代理回报 `SKILL_UNAVAILABLE`、派发失败或拿不到有效路径时,在主 session 内联加载 Superpowers `writing-plans` 技能创建计划(降级回退),并记住本会话派发不可用,之后再进 Step 1 直接内联
72
79
 
73
80
  ### 2. 更新计划状态并联合确认工作方式
74
81
 
@@ -240,6 +247,14 @@ Open 阶段已经根据 `isolation` 准备好当前目录、分支或 Worktree
240
247
  - 不提前同步到 main spec,归档时统一同步
241
248
  - 小规模增量直接改 delta spec 时,应在 commit message 中注明,便于归档时判断 design doc 漂移
242
249
 
250
+ **handoff 同步**:delta spec 的增、改、删都会使设计交接包(`handoff_hash`)过期。Build 阶段可随时直接重新生成,无需回退当前 phase 或 step:
251
+
252
+ ```bash
253
+ comet handoff <change-name> design --write
254
+ ```
255
+
256
+ 重新生成会从当前 OpenSpec artifacts 重建 handoff 并更新 `handoff_hash`,不会改变 `phase` 字段或 Runtime `currentStep`;刷新后可按 build 阶段继续推进。
257
+
243
258
  ### 5. 上下文管理
244
259
 
245
260
  Build 是最长阶段,可能跨越大量任务。为支持上下文压缩后断点恢复:
@@ -207,7 +207,7 @@ canonical_spec: openspec
207
207
 
208
208
  ### 3. 更新 Comet 状态
209
209
 
210
- 先记录 design_doc 路径。如果 Spec Patch 回写了 delta spec(新增或修改了 `specs/*/spec.md`),必须重新生成 handoff 以更新 hash:
210
+ 先记录 design_doc 路径。如果 Spec Patch 回写了 delta spec(新增、修改或删除了 `specs/*/spec.md`),必须重新生成 handoff 以更新 hash:
211
211
 
212
212
  ```bash
213
213
  # 记录 design_doc 路径
@@ -220,7 +220,7 @@ comet handoff <change-name> design --write
220
220
  comet guard <change-name> design --apply
221
221
  ```
222
222
 
223
- 如果没有 delta spec 变更,跳过 handoff 重新生成步骤。状态文件自动更新,无需手动编辑其他字段。
223
+ delta spec 的增、改、删都会改变 handoff hash,因此删除 delta spec 同样必须重新生成 handoff;否则记录的 `handoff_hash` 与当前 OpenSpec artifacts 不再匹配,design guard 将拒绝推进。如果没有 delta spec 变更,跳过 handoff 重新生成步骤。状态文件自动更新,无需手动编辑其他字段。
224
224
 
225
225
  ### 3a. 可选主动式上下文压缩
226
226
 
@@ -36,9 +36,9 @@ CLI 会在创建 change 前完成分支或 worktree 绑定、复用已登记的
36
36
  - 只有任务因进程中断、换设备后本机状态缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏而无法继续时,才读取[恢复参考](reference/recovery.md)。
37
37
  ## Shape
38
38
 
39
- 先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。
39
+ 先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。用户直接提供文件、附件、链接或本地路径作为需求来源时进入源文档完整覆盖模式:完整读取并记录 `complete`、`partial` 或 `unavailable` 状态,分块读取只改变读取顺序和工作记忆管理,不改变最终覆盖集合;`brief.md` 先保存完整来源需求和覆盖状态,再提出歧义、遗漏或隐含边界问题;可执行来源单元必须同时映射到完整目标 Spec 和至少一个验收 ID,背景、非目标或已废止内容只保留归类、理由和替代关系;修正后的旧单元标为 `superseded` 并指向替代单元;`partial`、`unavailable`、未映射或未确认内容保持 `[blocking]`。仅用于排错、取证、审查或实现参考的材料不自动触发,用途不明时先澄清;摘要不能替代来源覆盖映射。
40
40
 
41
- 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。大型需求需要拆分时,在 Supervisor Change 根目录维护 `children.yaml`,用 `depends_on` 表达真实先后关系,并用 `covers` 覆盖 Supervisor Change 验收项;数组顺序只用于稳定展示和同等就绪时的优先级。
41
+ 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。大型需求需要拆分时,在 Supervisor Change 根目录维护 `children.yaml`,用 `depends_on` 表达真实先后关系,并用 `covers` 覆盖 Supervisor Change 的可读验收索引;数组顺序只用于稳定展示和同等就绪时的优先级。新建的 v2 `children.yaml` 只索引 brief 派生的父级验收项,`acceptance_index` 保存每个 ID 的来源和完整文字;Spec 派生的细粒度检查仍由 Runtime 的完整验收矩阵验证,不要求初始 child 计划重复列出。历史 v1 文件继续按原契约接受。
42
42
 
43
43
  大型需求在最终 Shape 确认前执行一次拆分检测:只有至少两个结果可独立实现和验证、验收项能完整映射且有真实依赖/并行价值时建议 Supervisor Change 模式;目标紧耦合、反复修改同一核心区域、协调成本更高或用户要求单 change 时保持单一 Native change;需求文字长、任务条目多本身不能触发拆分。
44
44
  建议拆分时,Skill 将 `children.yaml` 草案、执行波次和验收覆盖摘要放入一次 Shape 确认;用户可确认、调整或保持单 change。确认前不得创建子 change、worktree 或派发 Agent。
@@ -58,12 +58,12 @@ Build 和 Verify 组成一个有界验收循环(Loop):Builder 提交候选
58
58
 
59
59
  确认一次 Supervisor Change Shape 即授权严格派生的子 change,不要求用户重复确认相同范围。Skill 只执行 Runtime continuation 返回的动作,并在每个 child 完成后重新读取 `readyChildren`,继续下一波;Supervisor Change 最后仍由 Verify 验证完整验收项。
60
60
 
61
- 状态包含 `children` 时,当前 change 是 Supervisor Change:不要运行 Supervisor Change Builder,只推进 `readyChildren`。每个 child 都是普通 Native change,必须在独立 worktree 中创建,以 Supervisor Change 的 `workspace.changeBranch` 为目标分支;没有依赖的 child 可以并行 Build/Verify,但 Archive 必须逐个使用 `finish=merge` 合入 Supervisor Change 分支。先提交 Supervisor Change 契约基线以保持集成工作区干净;只有 child 的 Archive 已合入 Supervisor Change 分支才算 `done`,随后才从更新后的 Supervisor Change HEAD 创建依赖它的 child。全部 child 为 `done` 后,执行 Supervisor Change continuation 进入 Verify,由新的 Verifier 在最终集成分支上检查 Supervisor Change 的完整验收项。Supervisor Change Verify 未通过时不要重开已归档 child;按 `repair-child` 提示在 `children.yaml` 中追加覆盖失败验收项的唯一 repair child,重新确认 Supervisor Change Shape 后继续。
61
+ 状态包含 `children` 时,当前 change 是 Supervisor Change:不要运行 Supervisor Change Builder,只推进 `readyChildren`。每个 child 都是普通 Native change,必须在独立 worktree 中创建,以 Supervisor Change 的 `workspace.changeBranch` 为目标分支;没有依赖的 child 可以并行 Build/Verify,但 Archive 必须逐个使用 `finish=merge` 合入 Supervisor Change 分支。先提交 Supervisor Change 契约基线以保持集成工作区干净;只有 child 的 Archive 已合入 Supervisor Change 分支才算 `done`,随后才从更新后的 Supervisor Change HEAD 创建依赖它的 child。全部 child 为 `done` 后,执行 Supervisor Change continuation 进入 Verify,由新的 Verifier 在最终集成分支上检查 Supervisor Change 的完整验收项。Supervisor Change Verify 未通过时不要重开已归档 child;按 `repair-child` 提示在 v2 `acceptance_index` 中补充实际失败的 Spec 验收文字,并在 `children.yaml` 中追加覆盖这些失败验收项的唯一 repair child,重新确认 Supervisor Change Shape 后继续。
62
62
 
63
63
  需求变化时先判断归属:
64
64
 
65
- - 当前需求只是实现有遗漏:从 Verify 或 Archive 使用 `--return-to-build` 回到 Build;
66
- - 用户可见行为或验收标准发生变化:回到 Shape,更新正式产物并重新确认;
65
+ - 当前需求只是实现有遗漏:从 Verify 使用 `--revise-implementation` 保留已确认需求并回到 Build;
66
+ - 用户可见行为或验收标准发生变化:从 Verify 使用 `--revise-requirements`,更新正式产物并重新确认 Shape;
67
67
  - 与当前需求无关:保留给另一个 change。
68
68
 
69
69
  用户明确补充当前范围时,按同一规则处理。
@@ -84,7 +84,7 @@ Verifier 先读取验收项、brief、完整目标 Spec、实际实现和 Runtim
84
84
 
85
85
  Verifier 保持只读。如果现有检查不足,就在 Runtime 返回的 `inputOptions.template` 中列出还需要运行哪些检查,由 Runtime 执行并把结果返回给 Verifier。
86
86
 
87
- Verifier 最终必须逐项标记为通过(`passed`)、未通过(`failed`)或暂时无法验证(`blocked`),一项不能漏,也不能重复。未通过或无法验证时,写出下一轮 Build 可直接处理的原因。无法启动 Verifier、Verifier 执行出错或缺少外部信息时,按命令参考和最新 `continuation` 处理。
87
+ Verifier 最终必须逐项标记为通过(`passed`)、未通过(`failed`)或暂时无法验证(`blocked`),一项不能漏,也不能重复。未通过或无法验证时,写出下一轮 Build 可直接处理的原因。无法启动 Verifier、Verifier 执行出错或缺少外部信息时,按命令参考和最新 `continuation` 处理。skill-coordinated Verifier 通过且 Runtime 等待用户决策时,只有用户接受当前结果才用 `--accept-result` 进入 Archive;如果用户要求修改实现或验收标准,分别使用 `--revise-implementation` 或 `--revise-requirements`。
88
88
 
89
89
  完成标准:Runtime 已接受完整的 Verifier 结果,并明确进入 Build、Archive、等待用户(`await-user`)、阻塞(`blocked`)或完成(`done`)中的一种状态。
90
90
 
@@ -101,7 +101,7 @@ Verifier 最终必须逐项标记为通过(`passed`)、未通过(`failed`
101
101
  每次命令后只处理最新的 `continuation`:
102
102
 
103
103
  - `continue`:执行 `commandArgs`,并按模板填写 `inputOptions`;
104
- - `await-user`:等待列出的用户决定;
104
+ - `await-user`:等待列出的用户决定;如有 `commandAlternatives`,选择匹配项执行完整 `commandArgs`,保留 `--expected-state-version` 和 `--expected-action`。alternative 过期时重新读取最新 `continuation`,不得重构无 guard 命令;
105
105
  - `blocked`:先处理列出的阻塞原因或恢复动作;
106
106
  - `done`:结束。
107
107
 
@@ -29,7 +29,7 @@ Agent 只编辑 brief、完整目标规格和 Supervisor Change 的 `children.ya
29
29
 
30
30
  ## Brief
31
31
 
32
- `brief.md` 使用以下非空一级标题:
32
+ `brief.md` 是 Native 的持久化澄清产物,使用以下非空一级标题:
33
33
 
34
34
  ```text
35
35
  # Outcome
@@ -50,9 +50,9 @@ Open questions 中只有真实未解决的用户问题使用:
50
50
  - [blocking] CONFIRM: <最终共享理解>
51
51
  ```
52
52
 
53
- 每个决定确认后立即写入 Decisions 和完整目标规格,再移除对应阻塞项。正式产物只记录结论和理由,不记录模型的隐藏推理过程。
53
+ 每个决定确认后立即写入 Decisions 和完整目标规格,再移除对应阻塞项。正式产物只记录结论和理由,不记录模型的隐藏推理过程。`brief.md` 是 Native 的持久化澄清产物;用户直接提供文件、附件、链接或本地路径作为需求来源时,在 `brief.md` 的 `# Scope` 下建立 `## Source coverage` 作为唯一来源覆盖映射,完整目标 Spec 不重复来源表,只完整表达所有当前有效可执行语义。
54
54
 
55
- 验收标准必须具体、可观察且互不重复。使用简单顺序 ID,例如 `A1`、`A2`、`A3`;ID 只用于结果映射,不从内容计算,也不代表文件身份。Runtime 在 Shape 确认时保存完整验收文字及其来源。Supervisor Change 的 `children.yaml` 使用 `comet.native.children.v1`,每个 child 只包含 `name`、`depends_on` 和 `covers`。名称必须唯一,依赖必须存在且无环,全部 Supervisor Change 验收 ID 都必须被覆盖。Runtime 将其与 Supervisor Change 验收项一起确认;修改后 Supervisor Change 返回 Shape。
55
+ 验收标准必须具体、可观察且互不重复。使用简单顺序 ID,例如 `A1`、`A2`、`A3`;ID 只用于结果映射,不从内容计算,也不代表文件身份。Runtime 在 Shape 确认时保存完整验收文字及其来源。直接来源覆盖映射为每个单元记录来源定位、`complete`/`partial`/`unavailable` 读取状态、保留语义、对应的 Spec 位置、对应的验收 ID、`covered`/`needs-clarification`/`background`/`non-goal`/`superseded` 覆盖状态以及理由或替代关系;当前有效可执行单元必须同时具有 Spec 位置和验收 ID,背景、非目标和已废止来源单元不要求 Spec 位置或验收 ID;验收条件至少覆盖原始来源的全部当前有效可执行语义,`partial`、`unavailable`、未覆盖内容或缺少双重映射的可执行单元保持阻塞。Supervisor Change 的新 `children.yaml` 使用 `comet.native.children.v2`:`acceptance_index` 为 brief 派生的父级验收 ID 保存 `source` 和完整 `text`,每个 child 仍只包含 `name`、`depends_on` 和 `covers`,且 `covers` 必须覆盖索引中的全部 ID。Spec 派生验收仍保留在 Runtime 完整验收矩阵中;只有修复阶段才把实际失败的 Spec ID 连同来源和文字补入索引。名称必须唯一,依赖必须存在且无环。历史 `comet.native.children.v1` 继续接受其原有的完整验收覆盖格式;修改后 Supervisor Change 返回 Shape。
56
56
 
57
57
  ## 完整目标规格
58
58
 
@@ -10,7 +10,7 @@
10
10
  - **用户决定**:不同选择会实质改变输出、默认行为、失败结果、范围或不可逆影响。由用户确认。
11
11
  - **实现选择**:不改变用户可见结果的算法、结构和工作方式。由 Agent 决定。
12
12
 
13
- 只有歧义会实质改变用户可见结果,而且无法从用户要求、正式规格或项目规则中可靠确定时,才询问用户。问题应来自真实分歧;普通实现选择由 Agent 直接决定。
13
+ 只有歧义会实质改变用户可见结果,而且无法从用户要求、正式规格或项目规则中可靠确定时,才询问用户。问题应来自真实分歧;普通实现选择由 Agent 直接决定。用户直接提供文件、附件、链接或本地路径作为需求来源时,`brief.md` 是持久化澄清产物:先在 `# Scope` 下的 `## Source coverage` 呈现完整来源需求和覆盖状态,再在 `# Open questions` 提出歧义、遗漏或隐含边界问题;仅供排错、取证、审查或实现参考的材料不自动触发,用途不明时先澄清。来源文档按标题、段落、列表、表格、代码块、示例、约束、链接和边界建立单元并记录读取与覆盖状态;可执行来源单元必须同时进入完整目标 Spec 和至少一个验收 ID,背景或非目标只需保留归类和理由,不要求验收 ID;用户修正原文时将旧单元标为 `superseded` 并链接替代单元。不可访问的链接、无法解析的文件、部分读取来源或未映射的可执行来源单元保持 `[blocking]`;分块读取不减少最终覆盖集合,摘要不能替代来源覆盖映射。
14
14
 
15
15
  把模糊行为改写为可比较的“输入 → 输出”或“触发 → 结果”。每个问题应包含:
16
16
 
@@ -13,7 +13,7 @@ comet native <group> <command> --help
13
13
  ## Runtime 返回的下一步
14
14
 
15
15
  - `disposition`:说明现在应该继续、等待用户、处理阻塞还是结束;
16
- - `commandArgs`:Runtime 要求执行的完整命令参数;
16
+ - `commandArgs` / `commandAlternatives`:Runtime 要求执行的完整命令参数;alternative 是互斥用户决策对应的完整命令,选择匹配项执行,不要合并多个 alternative;
17
17
  - `inputOptions`:这次命令需要填写的字段和 JSON 模板;
18
18
  - `workspace` / `preparation`:实际工作目录和 change 创建结果;
19
19
  - `stateVersion` / `loop`:当前状态版本和验收循环进度;
@@ -21,11 +21,11 @@ comet native <group> <command> --help
21
21
  - `verifierDispatch`:启动独立 Verifier 所需的输入;
22
22
  - `workspaceFinishResult` / `recoveryArgs`:归档后的工作区收尾结果和恢复命令。
23
23
 
24
- 模板中的尖括号表示需要填写的值。`await-user` 表示先等待用户决定,此时不执行推进命令。`localExecution: absent` 只表示这台机器当前没有正在运行的本机任务,不代表 change 已损坏。
24
+ 模板中的尖括号表示需要填写的值。`await-user` 表示先等待用户决定,此时不执行推进命令。若 `commandArgs` 为 `null` 且返回了 `commandAlternatives`,先确认用户决定,再执行对应 alternative 的完整 `commandArgs`,保留其中的 `--expected-state-version` 和 `--expected-action`。命令因状态过期或动作不匹配失败时,重新读取最新 `continuation`,按当前状态继续;不要自行拼接不带 guard 的命令。`localExecution: absent` 只表示这台机器当前没有正在运行的本机任务,不代表 change 已损坏。
25
25
 
26
26
  ## 填写命令输入
27
27
 
28
- 把 `inputOptions.template` 复制到系统临时 JSON 文件,只替换模板要求填写的内容,然后执行 `continuation.commandArgs`。命令结束后删除临时文件。模板中已有的验收轮次、Verifier 尝试次数、状态版本和任务标识都原样保留;只填写模板公开的字段。
28
+ 把 `inputOptions.template` 复制到系统临时 JSON 文件,只替换模板要求填写的内容,然后执行 `continuation.commandArgs` 或所选 `commandAlternative.commandArgs`。命令结束后删除临时文件。模板中已有的验收轮次、Verifier 尝试次数、状态版本和任务标识都原样保留;只填写模板公开的字段。
29
29
 
30
30
  - `builder-handoff`:提交本轮实现摘要、处理的验收 ID、Builder 实际做过的开发检查和已知限制。验收结论留给 Verifier。
31
31
  - `dispatch-verifier`:列出当前候选需要由 Runtime 执行的检查。确认没有适用的命令检查时提交空列表。
@@ -0,0 +1,121 @@
1
+ ---
2
+ name: comet-review
3
+ description: "手动审查当前 Comet change 的实现差异,只报告正确性、安全和边界问题,不推进工作流。"
4
+ disable-model-invocation: true
5
+ ---
6
+
7
+ # Comet 手动代码审查
8
+
9
+ 对当前选中的 Comet change 执行一次按需、只读的代码审查。这个入口不属于任何阶段,也不替代 Build 或 Verify 的验证和审查。
10
+
11
+ 本入口独立于 `review_mode`:`review_mode` 控制流程内的自动 review 策略,而 `/comet-review` 只代表用户手动触发的单次审查;调用本入口不得读取、修改或覆盖当前 change 的 `review_mode`。
12
+
13
+ ## 不可变约束
14
+
15
+ 本 Skill 的整个调用必须保持只读:
16
+
17
+ - 不修改、创建或删除文件;
18
+ - 不暂存、提交、切换分支、创建分支或创建 worktree;
19
+ - 不运行 `comet state select`、`comet native select`、`comet state set`、`comet state transition`、阶段守卫、`comet native next` 或归档命令;
20
+ - 不修复发现的问题,不推进 phase,不更新 tasks、状态、验证报告或审查记录;
21
+ - 不把本次结果称为 Verify 通过,也不把“没有发现”视为测试已经通过。
22
+
23
+ 只允许执行读取文件、查询状态和查看 Git 差异所需的命令。任何可能运行项目代码、安装依赖或产生文件的检查都不属于本入口。
24
+
25
+ ## 1. 定位项目与当前 change
26
+
27
+ 1. 使用只读 Git 查询确定项目根目录;如果不是 Git 仓库,则使用当前 Comet 项目根目录。
28
+ 2. 在项目根目录运行:
29
+
30
+ ```bash
31
+ comet status . --json
32
+ ```
33
+
34
+ 3. 读取 `.comet/current-change.json`,并按以下顺序确定审查对象:
35
+ - 文件包含有效的 `comet.selection.v2` 时,使用其中的 `workflow` 和 `change`;
36
+ - selection 缺失,且状态输出中只有一个未归档的 Comet change 时,只在本次审查内采用该 change,不写入 selection;
37
+ - selection 缺失且存在多个 change 时,列出名称、workflow 和 phase,请用户指定一个后停止;
38
+ - selection 指向缺失、已归档或状态无效的 change 时,报告 stale/invalid selection 后停止,不自行修复。
39
+
40
+ 忽略不受 Comet 管理的普通 OpenSpec change。不得因为默认 workflow 与 selection 不同而改用默认 workflow。
41
+
42
+ ## 2. 收集审查上下文
43
+
44
+ 只读取当前 change 的必要上下文,并为每个事实保留来源路径或命令。
45
+
46
+ ### Classic
47
+
48
+ 1. 先读取并遵守 `comet-classic/reference/classic-layout.md`,解析当前项目的 Classic 逻辑根。
49
+ 2. 读取当前 change 的 `proposal.md`、`design.md`、`tasks.md` 和 `specs/*/spec.md`;存在关联 Design Doc 时一并读取。
50
+ 3. 使用以下只读状态查询获得 phase、基线和已有证据引用:
51
+
52
+ ```bash
53
+ comet state get <change-name> phase
54
+ comet state get <change-name> base_ref
55
+ comet state get <change-name> plan
56
+ comet state get <change-name> verification_report
57
+ ```
58
+
59
+ 4. 读取存在的 plan、验证报告,以及 `comet status . --json` 返回的 build/verify command checks。缺失证据应标为“未提供”,不能推断为失败或通过。
60
+
61
+ ### Native
62
+
63
+ 运行以下只读命令:
64
+
65
+ ```bash
66
+ comet native show <change-name> --json
67
+ comet native status <change-name> --details --json
68
+ ```
69
+
70
+ 读取返回的 brief、完整 proposed Specs、acceptance、Builder handoff、checks、verification、risks、blockers 和 verification report 引用。只使用当前 candidate/iteration 的证据;历史轮次仅用于解释残留风险,不得覆盖当前状态。
71
+
72
+ ## 3. 确定实现差异
73
+
74
+ 1. 先运行 `git status --short --untracked-files=all`,完整枚举已暂存、未暂存和未跟踪的工作树状态。
75
+ 2. 结合当前 change 的需求、工作区绑定、Git 历史和工作树状态,确定最可信且与当前 change 相关的审查范围。对于 Classic,优先使用有效的 plan `base-ref`;不存在或无效时回退到状态中的 `base_ref`,不要求两者一致。只有两者均无效时,才将 Classic 基线视为缺失。对于 Native,将状态中的工作区关系和当前 candidate 的实现范围证据作为判断依据。
76
+ 3. 查看从可信基线到当前工作树的完整差异,包括已提交、已暂存和未暂存修改。对属于当前 change 的所有未跟踪文件,包括源码、测试、文档、配置和元数据(例如 `SKILL.md` 与 `agents/openai.yaml`),直接读取内容并明确标注其未跟踪状态。
77
+ 4. 排除明确归属于其他 change 或用户无关工作的差异。只有歧义会实质影响审查结论时才询问用户;否则基于现有证据继续审查,并在结果中说明范围判断和假设。
78
+
79
+ 如果结合上述证据仍无法确定可信且可验证的基线,继续审查当前可见的工作树差异,并在结果中显著标注“审查范围不完整”。
80
+
81
+ ## 4. 执行审查
82
+
83
+ 根据需求、任务和当前差异进行一次聚焦审查,只检查:
84
+
85
+ - 实现正确性和明显逻辑错误;
86
+ - 安全风险、权限或路径边界问题;
87
+ - 错误处理、兼容性和重要边界条件;
88
+ - 任务遗漏、实现与当前 change 明确要求不一致;
89
+ - 测试是否覆盖本次行为变化,以及已有测试证据能否支撑相应结论。
90
+
91
+ 不要把风格偏好、无关重构或没有具体影响的猜测列为 finding。每条 finding 必须能指向具体文件和行号,并说明可触发的行为或风险;证据不足时降低严重度或放入“开放问题”。
92
+
93
+ 严重度仅使用:
94
+
95
+ - `CRITICAL`:安全破坏、数据丢失或核心流程不可用;
96
+ - `IMPORTANT`:明确的正确性错误、核心验收遗漏或高概率回归;
97
+ - `WARNING`:真实但非阻塞的边界风险或测试缺口;
98
+ - `SUGGESTION`:有明确收益但不影响当前正确性的改进。
99
+
100
+ ## 5. 输出
101
+
102
+ 先输出 findings,按严重度排序。每条使用以下格式:
103
+
104
+ ```text
105
+ [IMPORTANT] 简短标题 — path/to/file.ts:123
106
+ 影响:什么输入或场景会出现什么错误。
107
+ 依据:与 diff、任务、规格或证据的具体对应关系。
108
+ ```
109
+
110
+ 随后输出:
111
+
112
+ - `审查范围`:workflow、change、phase、基线、纳入的差异和任何范围限制;
113
+ - `证据状态`:已读取的测试/构建/验证证据及其新鲜度,不重新执行测试;
114
+ - `开放问题`:只有确实阻碍判断的问题;
115
+ - `结论`:finding 数量汇总,或明确写“未发现具体问题”。
116
+
117
+ 即使没有 finding,也必须说明残余风险和未执行的检查。结尾固定提醒:
118
+
119
+ > 这是只读的手动审查,不会推进 Comet phase,也不能替代 `/comet-verify` 或 Native Verify。
120
+
121
+ 如果用户随后要求修复 finding,把修复视为新的写入任务,退出本 Skill,并按仓库当前工作流规则重新进入开发流程。
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Comet 手动代码审查"
3
+ short_description: "只读审查当前 change,不推进工作流"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -1 +1 @@
1
- {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../app/commands/init.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAK1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAcnE,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA6C/F,OAAO,EAAK,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC,CA+BD;AAqBD,KAAK,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAClE,KAAK,mBAAmB,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAkBnE,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAkGF,iBAAS,wBAAwB,CAAC,CAAC,SAAS,aAAa,EACvD,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC9C,WAAW,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,CAAC,CAUH;AA6MD,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CA40BjC;AAED,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,CAAC"}
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../app/commands/init.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAK1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAcnE,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA6C/F,OAAO,EAAK,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC,CA+BD;AAqBD,KAAK,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAClE,KAAK,mBAAmB,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAkBnE,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAkGF,iBAAS,wBAAwB,CAAC,CAAC,SAAS,aAAa,EACvD,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC9C,WAAW,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,CAAC,CAUH;AA6MD,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAw0BjC;AAED,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,CAAC"}
@@ -2,7 +2,7 @@ import path from 'path';
2
2
  import os from 'os';
3
3
  import { checkbox, select } from '@inquirer/prompts';
4
4
  import { platformSelectPrompt } from './platform-select-prompt.js';
5
- import { PLATFORMS, getPlatformSkillsDir, } from '../../platform/install/platforms.js';
5
+ import { PLATFORMS, getPlatformSkillsDir, resolveOpenSpecMirrorPlatformIds, } from '../../platform/install/platforms.js';
6
6
  import { resolvePlatformTarget, } from '../../platform/install/platform-targets.js';
7
7
  import { detectPlatforms, hasSkills, getBaseDir, } from '../../platform/install/detect.js';
8
8
  import { readProjectRegistry, upsertProjectInstallation, } from '../../platform/install/project-registry.js';
@@ -447,13 +447,10 @@ export async function initCommand(targetPath, options = {}) {
447
447
  }
448
448
  const osToolIds = Array.from(new Set(plans.filter((p) => p.osAction !== 'skip').map((p) => p.platform.openspecToolId)));
449
449
  const spPlatformIds = plans.filter((p) => p.spAction !== 'skip').map((p) => p.platform.id);
450
- // OpenCode-compatible platforms reuse the opencode OpenSpec tool id; mirror
451
- // the opencode output into their platform-specific config directories.
452
450
  const selectedPlatformIdsForOs = plans
453
451
  .filter((p) => p.osAction !== 'skip')
454
452
  .map((p) => p.platform.id);
455
- const mirrorOpenCodePlatformIds = selectedPlatformIdsForOs.filter((id) => ['zcode', 'mimocode'].includes(id));
456
- const mirrorCodeBuddyPlatformIds = selectedPlatformIdsForOs.filter((id) => id === 'workbuddy');
453
+ const mirrorPlatformIds = resolveOpenSpecMirrorPlatformIds(selectedPlatformIdsForOs);
457
454
  const selectedNpmDeps = await selectNpmDeps(projectPath, spPlatformIds, options, lang, includesWorkflow(workflowSelection, 'classic') ? 'classic' : 'native');
458
455
  const shouldInstallOpenSpecCli = selectedNpmDeps.has('openspec');
459
456
  const shouldInstallSuperpowers = selectedNpmDeps.has('superpowers');
@@ -488,9 +485,9 @@ export async function initCommand(targetPath, options = {}) {
488
485
  if ((osToolIds.length > 0 || requiresClassicArtifactRoot) && !osFailureReason) {
489
486
  log(`\n ${t(lang, 'installingOS')} ${osToolIds.length > 0 ? osToolIds.join(', ') : 'artifact root'}`);
490
487
  try {
491
- osGlobalStatus = await installOpenSpec(projectPath, osToolIds, scope, shouldInstallOpenSpecCli, mirrorOpenCodePlatformIds, scope === 'project' ? workflowDecision?.classicArtifactLayout : 'legacy', assertClassicProjectMutationAllowed, (error) => {
488
+ osGlobalStatus = await installOpenSpec(projectPath, osToolIds, scope, shouldInstallOpenSpecCli, mirrorPlatformIds, scope === 'project' ? workflowDecision?.classicArtifactLayout : 'legacy', assertClassicProjectMutationAllowed, (error) => {
492
489
  osFailureReason = error.message;
493
- }, mirrorCodeBuddyPlatformIds);
490
+ }, [], [], selectedPlatformIdsForOs);
494
491
  if (osGlobalStatus === 'installed' && requiresClassicArtifactRoot) {
495
492
  await assertClassicProjectMutationAllowed?.();
496
493
  await assertClassicOpenSpecRootHealthy(projectPath, classicLayoutPaths(projectPath, workflowDecision.classicArtifactLayout));
@@ -770,8 +767,7 @@ export async function initCommand(targetPath, options = {}) {
770
767
  await createWorkingDirs(projectPath, language.artifactLanguage, workflowDecision.classicArtifactLayout, classicLayoutInitializationPermit);
771
768
  }
772
769
  workingDirsCreated = true;
773
- await syncCometProjectInstructions(projectPath, language.id, includesWorkflow(workflowSelection, 'native') &&
774
- (initialProjectConfigDocument?.ambient_resume ?? true));
770
+ await syncCometProjectInstructions(projectPath, language.id, initialProjectConfigDocument?.ambient_resume ?? true);
775
771
  const successfulCometPlatforms = new Set(results
776
772
  .filter((result) => result.comet !== 'failed' &&
777
773
  plans.some((plan) => plan.platform.id === result.platform.id && plan.cmAction !== 'skip'))