@rpamis/comet 0.4.0-beta.17 → 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 (446) hide show
  1. package/README.md +66 -26
  2. package/assets/manifest.json +4 -1
  3. package/assets/skills/comet/scripts/comet-archive.mjs +120 -120
  4. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +79 -79
  5. package/assets/skills/comet/scripts/comet-guard.mjs +134 -134
  6. package/assets/skills/comet/scripts/comet-handoff.mjs +106 -106
  7. package/assets/skills/comet/scripts/comet-hook-guard.mjs +130 -130
  8. package/assets/skills/comet/scripts/comet-hook-router.mjs +115 -115
  9. package/assets/skills/comet/scripts/comet-intent.mjs +6 -6
  10. package/assets/skills/comet/scripts/comet-resume-probe.mjs +78 -78
  11. package/assets/skills/comet/scripts/comet-runtime.mjs +194 -193
  12. package/assets/skills/comet/scripts/comet-state.mjs +117 -117
  13. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +96 -96
  14. package/assets/skills/comet-build/SKILL.md +36 -62
  15. package/assets/skills/comet-classic/SKILL.md +14 -8
  16. package/assets/skills/comet-classic/reference/comet-yaml-fields.md +1 -1
  17. package/assets/skills/comet-classic/reference/scripts.md +3 -1
  18. package/assets/skills/comet-classic/reference/workspace.md +23 -0
  19. package/assets/skills/comet-design/SKILL.md +2 -2
  20. package/assets/skills/comet-native/SKILL.md +18 -15
  21. package/assets/skills/comet-native/reference/artifacts.md +5 -4
  22. package/assets/skills/comet-native/reference/clarification.md +1 -1
  23. package/assets/skills/comet-native/reference/commands.md +4 -4
  24. package/assets/skills/comet-native/reference/recovery.md +1 -1
  25. package/assets/skills/comet-native/reference/workspace.md +4 -4
  26. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +116 -115
  27. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +148 -148
  28. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +100 -100
  29. package/assets/skills/comet-native/scripts/comet-native-init.mjs +118 -118
  30. package/assets/skills/comet-native/scripts/comet-native-new.mjs +118 -118
  31. package/assets/skills/comet-native/scripts/comet-native-next.mjs +121 -121
  32. package/assets/skills/comet-native/scripts/comet-native-root.mjs +108 -108
  33. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +157 -156
  34. package/assets/skills/comet-native/scripts/comet-native-select.mjs +133 -133
  35. package/assets/skills/comet-native/scripts/comet-native-show.mjs +109 -109
  36. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +89 -89
  37. package/assets/skills/comet-native/scripts/comet-native-status.mjs +109 -109
  38. package/assets/skills/comet-open/SKILL.md +24 -5
  39. package/assets/skills/comet-review/SKILL.md +121 -0
  40. package/assets/skills/comet-review/agents/openai.yaml +5 -0
  41. package/assets/skills-zh/comet-build/SKILL.md +36 -62
  42. package/assets/skills-zh/comet-classic/SKILL.md +14 -8
  43. package/assets/skills-zh/comet-classic/reference/comet-yaml-fields.md +1 -1
  44. package/assets/skills-zh/comet-classic/reference/scripts.md +3 -1
  45. package/assets/skills-zh/comet-classic/reference/workspace.md +23 -0
  46. package/assets/skills-zh/comet-design/SKILL.md +2 -2
  47. package/assets/skills-zh/comet-native/SKILL.md +18 -15
  48. package/assets/skills-zh/comet-native/reference/artifacts.md +5 -4
  49. package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
  50. package/assets/skills-zh/comet-native/reference/commands.md +4 -4
  51. package/assets/skills-zh/comet-native/reference/recovery.md +1 -1
  52. package/assets/skills-zh/comet-native/reference/workspace.md +4 -4
  53. package/assets/skills-zh/comet-open/SKILL.md +24 -5
  54. package/assets/skills-zh/comet-review/SKILL.md +121 -0
  55. package/assets/skills-zh/comet-review/agents/openai.yaml +5 -0
  56. package/dist/app/cli/index.js +20 -1
  57. package/dist/app/cli/index.js.map +1 -1
  58. package/dist/app/commands/classic.d.ts.map +1 -1
  59. package/dist/app/commands/classic.js +2 -0
  60. package/dist/app/commands/classic.js.map +1 -1
  61. package/dist/app/commands/eval.d.ts +9 -2
  62. package/dist/app/commands/eval.d.ts.map +1 -1
  63. package/dist/app/commands/eval.js +293 -48
  64. package/dist/app/commands/eval.js.map +1 -1
  65. package/dist/app/commands/init.d.ts.map +1 -1
  66. package/dist/app/commands/init.js +5 -8
  67. package/dist/app/commands/init.js.map +1 -1
  68. package/dist/app/commands/update.d.ts.map +1 -1
  69. package/dist/app/commands/update.js +5 -6
  70. package/dist/app/commands/update.js.map +1 -1
  71. package/dist/domains/comet-classic/classic-cli.d.ts +1 -1
  72. package/dist/domains/comet-classic/classic-cli.d.ts.map +1 -1
  73. package/dist/domains/comet-classic/classic-cli.js +3 -0
  74. package/dist/domains/comet-classic/classic-cli.js.map +1 -1
  75. package/dist/domains/comet-classic/classic-command-context.d.ts +9 -0
  76. package/dist/domains/comet-classic/classic-command-context.d.ts.map +1 -1
  77. package/dist/domains/comet-classic/classic-command-context.js +10 -0
  78. package/dist/domains/comet-classic/classic-command-context.js.map +1 -1
  79. package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
  80. package/dist/domains/comet-classic/classic-current-change.js +29 -3
  81. package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
  82. package/dist/domains/comet-classic/classic-guard.d.ts.map +1 -1
  83. package/dist/domains/comet-classic/classic-guard.js +4 -4
  84. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  85. package/dist/domains/comet-classic/classic-handoff.d.ts.map +1 -1
  86. package/dist/domains/comet-classic/classic-handoff.js +44 -6
  87. package/dist/domains/comet-classic/classic-handoff.js.map +1 -1
  88. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  89. package/dist/domains/comet-classic/classic-hook-guard.js +16 -2
  90. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  91. package/dist/domains/comet-classic/classic-intent-command.d.ts.map +1 -1
  92. package/dist/domains/comet-classic/classic-intent-command.js +2 -1
  93. package/dist/domains/comet-classic/classic-intent-command.js.map +1 -1
  94. package/dist/domains/comet-classic/classic-resume-probe-command.d.ts.map +1 -1
  95. package/dist/domains/comet-classic/classic-resume-probe-command.js +4 -3
  96. package/dist/domains/comet-classic/classic-resume-probe-command.js.map +1 -1
  97. package/dist/domains/comet-classic/classic-runtime-run.d.ts +6 -0
  98. package/dist/domains/comet-classic/classic-runtime-run.d.ts.map +1 -1
  99. package/dist/domains/comet-classic/classic-runtime-run.js +58 -9
  100. package/dist/domains/comet-classic/classic-runtime-run.js.map +1 -1
  101. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  102. package/dist/domains/comet-classic/classic-state-command.js +39 -13
  103. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  104. package/dist/domains/comet-classic/classic-validate-command.d.ts.map +1 -1
  105. package/dist/domains/comet-classic/classic-validate-command.js +2 -2
  106. package/dist/domains/comet-classic/classic-validate-command.js.map +1 -1
  107. package/dist/domains/comet-classic/classic-workspace-command.d.ts +3 -0
  108. package/dist/domains/comet-classic/classic-workspace-command.d.ts.map +1 -0
  109. package/dist/domains/comet-classic/classic-workspace-command.js +45 -0
  110. package/dist/domains/comet-classic/classic-workspace-command.js.map +1 -0
  111. package/dist/domains/comet-classic/classic-workspace.d.ts +38 -0
  112. package/dist/domains/comet-classic/classic-workspace.d.ts.map +1 -0
  113. package/dist/domains/comet-classic/classic-workspace.js +315 -0
  114. package/dist/domains/comet-classic/classic-workspace.js.map +1 -0
  115. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  116. package/dist/domains/comet-entry/hook-adapter.js +5 -1
  117. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  118. package/dist/domains/comet-entry/hook-router-entry.d.ts +2 -0
  119. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  120. package/dist/domains/comet-entry/hook-router-entry.js +21 -1
  121. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  122. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  123. package/dist/domains/comet-entry/init-workflow.js +13 -5
  124. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  125. package/dist/domains/comet-native/index.d.ts +1 -0
  126. package/dist/domains/comet-native/index.d.ts.map +1 -1
  127. package/dist/domains/comet-native/index.js +1 -0
  128. package/dist/domains/comet-native/index.js.map +1 -1
  129. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  130. package/dist/domains/comet-native/native-archive-command.js +2 -0
  131. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  132. package/dist/domains/comet-native/native-atomic-file.d.ts.map +1 -1
  133. package/dist/domains/comet-native/native-atomic-file.js +17 -10
  134. package/dist/domains/comet-native/native-atomic-file.js.map +1 -1
  135. package/dist/domains/comet-native/native-children.d.ts +65 -0
  136. package/dist/domains/comet-native/native-children.d.ts.map +1 -0
  137. package/dist/domains/comet-native/native-children.js +453 -0
  138. package/dist/domains/comet-native/native-children.js.map +1 -0
  139. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -1
  140. package/dist/domains/comet-native/native-cli-help.js +13 -7
  141. package/dist/domains/comet-native/native-cli-help.js.map +1 -1
  142. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  143. package/dist/domains/comet-native/native-cli-shared.js +18 -5
  144. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  145. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -1
  146. package/dist/domains/comet-native/native-doctor-command.js +10 -5
  147. package/dist/domains/comet-native/native-doctor-command.js.map +1 -1
  148. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  149. package/dist/domains/comet-native/native-hook-guard.js +56 -4
  150. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  151. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  152. package/dist/domains/comet-native/native-next-command.js +179 -20
  153. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  154. package/dist/domains/comet-native/native-portable-continuation.d.ts +22 -9
  155. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -1
  156. package/dist/domains/comet-native/native-portable-continuation.js +178 -73
  157. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -1
  158. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts.map +1 -1
  159. package/dist/domains/comet-native/native-portable-migration-runtime.js +9 -4
  160. package/dist/domains/comet-native/native-portable-migration-runtime.js.map +1 -1
  161. package/dist/domains/comet-native/native-portable-runtime.d.ts +19 -1
  162. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -1
  163. package/dist/domains/comet-native/native-portable-runtime.js +168 -4
  164. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -1
  165. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -1
  166. package/dist/domains/comet-native/native-portable-state.js +13 -0
  167. package/dist/domains/comet-native/native-portable-state.js.map +1 -1
  168. package/dist/domains/comet-native/native-portable-status.d.ts +3 -0
  169. package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -1
  170. package/dist/domains/comet-native/native-portable-status.js +9 -1
  171. package/dist/domains/comet-native/native-portable-status.js.map +1 -1
  172. package/dist/domains/comet-native/native-portable-types.d.ts +1 -0
  173. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -1
  174. package/dist/domains/comet-native/native-portable-types.js.map +1 -1
  175. package/dist/domains/comet-native/native-pull-request-finish.d.ts +35 -0
  176. package/dist/domains/comet-native/native-pull-request-finish.d.ts.map +1 -0
  177. package/dist/domains/comet-native/native-pull-request-finish.js +282 -0
  178. package/dist/domains/comet-native/native-pull-request-finish.js.map +1 -0
  179. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -1
  180. package/dist/domains/comet-native/native-show-command.js +2 -1
  181. package/dist/domains/comet-native/native-show-command.js.map +1 -1
  182. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -1
  183. package/dist/domains/comet-native/native-status-discovery.js +24 -6
  184. package/dist/domains/comet-native/native-status-discovery.js.map +1 -1
  185. package/dist/domains/comet-native/native-workspace-finish.d.ts +6 -0
  186. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -1
  187. package/dist/domains/comet-native/native-workspace-finish.js +86 -35
  188. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -1
  189. package/dist/domains/comet-native/native-workspace-preparation.d.ts.map +1 -1
  190. package/dist/domains/comet-native/native-workspace-preparation.js +192 -133
  191. package/dist/domains/comet-native/native-workspace-preparation.js.map +1 -1
  192. package/dist/domains/dashboard/collector.d.ts +1 -1
  193. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  194. package/dist/domains/dashboard/collector.js +102 -87
  195. package/dist/domains/dashboard/collector.js.map +1 -1
  196. package/dist/domains/dashboard/native-adapter.d.ts +20 -0
  197. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  198. package/dist/domains/dashboard/native-adapter.js +11 -0
  199. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  200. package/dist/domains/dashboard/native-collector.d.ts +1 -0
  201. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  202. package/dist/domains/dashboard/native-collector.js +304 -55
  203. package/dist/domains/dashboard/native-collector.js.map +1 -1
  204. package/dist/domains/dashboard/native-legacy-adapter.d.ts +12 -5
  205. package/dist/domains/dashboard/native-legacy-adapter.d.ts.map +1 -1
  206. package/dist/domains/dashboard/native-legacy-adapter.js +12 -0
  207. package/dist/domains/dashboard/native-legacy-adapter.js.map +1 -1
  208. package/dist/domains/dashboard/server.d.ts.map +1 -1
  209. package/dist/domains/dashboard/server.js +5 -3
  210. package/dist/domains/dashboard/server.js.map +1 -1
  211. package/dist/domains/dashboard/types.d.ts +5 -0
  212. package/dist/domains/dashboard/types.d.ts.map +1 -1
  213. package/dist/domains/dashboard/web/assets/abnfDiagram-N423BO3Z-BYya6ofk.js +1 -0
  214. package/dist/domains/dashboard/web/assets/arc-DJbo4TD3.js +1 -0
  215. package/dist/domains/dashboard/web/assets/architectureDiagram-T3A2C74G-D8uZ2IB-.js +36 -0
  216. package/dist/domains/dashboard/web/assets/blockDiagram-VBNYF7ZC-B16BVj-r.js +132 -0
  217. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-BL17BIb8.js → c4Diagram-5PPSVZJV-ayV208_D.js} +1 -1
  218. package/dist/domains/dashboard/web/assets/channel-CEsrvmig.js +1 -0
  219. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-XWLMOyd4.js → chunk-2GRJ4B5K-Bn5o8p3H.js} +1 -1
  220. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-4drjXzHQ.js → chunk-2Q5K7J3B-BnF1SI6B.js} +1 -1
  221. package/dist/domains/dashboard/web/assets/chunk-5RXB4S5H-ETnma053.js +231 -0
  222. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-CQXqBSqQ.js → chunk-5VM5RSS4-Cuvy639H.js} +1 -1
  223. package/dist/domains/dashboard/web/assets/chunk-6Q2QTUOP-DOXBzl73.js +88 -0
  224. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-pMreYMW7.js → chunk-GF5L2VYU-CfREXlEl.js} +5 -5
  225. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-vQyyh3eG.js → chunk-JWPE2WC7-DWIdpYTb.js} +1 -1
  226. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-B_DDS2IK.js → chunk-KBJHAD2P-BnqPcfZB.js} +1 -1
  227. package/dist/domains/dashboard/web/assets/chunk-RYQCIY6F-DdJ00fZz.js +1 -0
  228. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-Cug8J1Qa.js → chunk-XXDRQBXY-BVDhdJyW.js} +1 -1
  229. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-CKFe0hg4.js +1 -0
  230. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-CKFe0hg4.js +1 -0
  231. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-IQKP-hgj.js → cose-bilkent-JH36ORCC-C-nglwHC.js} +1 -1
  232. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-CvvRO4J2.js → cynefin-VYW2F7L2-C8TMmrbP.js} +2 -2
  233. package/dist/domains/dashboard/web/assets/cynefinDiagram-MW4NZA55-C3pnQnjg.js +62 -0
  234. package/dist/domains/dashboard/web/assets/dagre-VZM6K2ZE-DY7UWiPI.js +4 -0
  235. package/dist/domains/dashboard/web/assets/{demo-CeIDHUFJ.js → demo-BfLsKrIL.js} +26 -5
  236. package/dist/domains/dashboard/web/assets/diagram-7IWD3JNH-voTyDkQ5.js +30 -0
  237. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-CN_LYqvT.js → diagram-B4RE2ZJO-B3VkUMck.js} +3 -3
  238. package/dist/domains/dashboard/web/assets/diagram-LBJQPF4R-BdJzPkv8.js +24 -0
  239. package/dist/domains/dashboard/web/assets/diagram-Q27KOJAE-Bsq0anZx.js +24 -0
  240. package/dist/domains/dashboard/web/assets/diagram-UB23O5K3-CBaKRbcu.js +41 -0
  241. package/dist/domains/dashboard/web/assets/ebnfDiagram-BXEA7PRR-Bl9Bm5wa.js +1 -0
  242. package/dist/domains/dashboard/web/assets/erDiagram-JOGREHBK-DjOZzfKI.js +85 -0
  243. package/dist/domains/dashboard/web/assets/flowDiagram-UKHOOZJN-C21e4siK.js +156 -0
  244. package/dist/domains/dashboard/web/assets/ganttDiagram-PKOTCBZU-Bs62uy6-.js +292 -0
  245. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-CaWEk3PM.js → gitGraphDiagram-DS77QQ5N-DQY_Ba00.js} +3 -3
  246. package/dist/domains/dashboard/web/assets/{graph--OzhPTMs.js → graph-DOmOIIwC.js} +1 -1
  247. package/dist/domains/dashboard/web/assets/{index-BNyOfAhu.js → index-BLv71GRj.js} +1 -1
  248. package/dist/domains/dashboard/web/assets/index-Be4r99N4.js +257 -0
  249. package/dist/domains/dashboard/web/assets/index-ByVYiA6g.css +1 -0
  250. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-BK07mNG0.js → infoDiagram-6WML65LV-CNgNNG9l.js} +1 -1
  251. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-mWnmaWfZ.js → ishikawaDiagram-WSZJBQD7-D9k1fTO1.js} +4 -4
  252. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-BPy-P7xx.js → journeyDiagram-NVQOT4AX-CHijUnPl.js} +1 -1
  253. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-3Jq9c_lo.js → kanban-definition-27J2QSJJ-DfWlntDq.js} +7 -7
  254. package/dist/domains/dashboard/web/assets/layout-D-LzfAck.js +1 -0
  255. package/dist/domains/dashboard/web/assets/{linear-kQyEW-4G.js → linear-o6hemX-z.js} +1 -1
  256. package/dist/domains/dashboard/web/assets/map-DxJ2ADlA.js +1 -0
  257. package/dist/domains/dashboard/web/assets/mermaid.core-B1DoOsPD.js +306 -0
  258. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CyyurUpv.js → mindmap-definition-FAOFIHXS-COMQF9Yy.js} +1 -1
  259. package/dist/domains/dashboard/web/assets/pegDiagram-VL7TDLO6-C_21n7Ps.js +1 -0
  260. package/dist/domains/dashboard/web/assets/pieDiagram-7S7Q4E2Y-D3EmoYDY.js +39 -0
  261. package/dist/domains/dashboard/web/assets/purify.es-Cz4mVeUR.js +3 -0
  262. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CpayUMjH.js → quadrantDiagram-CIZ2JOQS-C3fGdiMa.js} +4 -4
  263. package/dist/domains/dashboard/web/assets/railroadDiagram-AXF67PYL-mIsjemD-.js +1 -0
  264. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-Bi8YpfnA.js → requirementDiagram-LRYGKXZP-D_UMpS5e.js} +1 -1
  265. package/dist/domains/dashboard/web/assets/sankeyDiagram-W5VNT64P-D1MwyMF6.js +40 -0
  266. package/dist/domains/dashboard/web/assets/sequenceDiagram-SI44F4Z6-B8jp1RxX.js +162 -0
  267. package/dist/domains/dashboard/web/assets/sizeCapture-X5ZJPWSS-BKioI1Ql.js +1 -0
  268. package/dist/domains/dashboard/web/assets/stateDiagram-OKZ733FA-B7l8_CDo.js +1 -0
  269. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-BIxuwbeV.js +1 -0
  270. package/dist/domains/dashboard/web/assets/swimlanes-SLNWSIFB-951PRLYp.js +2 -0
  271. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-CEo6cGsy.js +8 -0
  272. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-aHrrtV-b.js → timeline-definition-Z64GVDOM-CeyA2KbI.js} +4 -4
  273. package/dist/domains/dashboard/web/assets/vennDiagram-T6HMQDX7-BHe0TZJV.js +34 -0
  274. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-RVQbcySh.js → wardleyDiagram-T6FBY63Y-CWqdSzJ-.js} +3 -3
  275. package/dist/domains/dashboard/web/assets/xychartDiagram-ELKLHX3M-DCKiZVPV.js +7 -0
  276. package/dist/domains/dashboard/web/index.html +2 -2
  277. package/dist/domains/dashboard/workspace.d.ts +27 -0
  278. package/dist/domains/dashboard/workspace.d.ts.map +1 -0
  279. package/dist/domains/dashboard/workspace.js +108 -0
  280. package/dist/domains/dashboard/workspace.js.map +1 -0
  281. package/dist/domains/eval/index.d.ts +3 -0
  282. package/dist/domains/eval/index.d.ts.map +1 -1
  283. package/dist/domains/eval/index.js +3 -0
  284. package/dist/domains/eval/index.js.map +1 -1
  285. package/dist/domains/eval/standalone-context.d.ts +19 -0
  286. package/dist/domains/eval/standalone-context.d.ts.map +1 -0
  287. package/dist/domains/eval/standalone-context.js +107 -0
  288. package/dist/domains/eval/standalone-context.js.map +1 -0
  289. package/dist/domains/eval/standalone-static-collect.d.ts +22 -0
  290. package/dist/domains/eval/standalone-static-collect.d.ts.map +1 -0
  291. package/dist/domains/eval/standalone-static-collect.js +779 -0
  292. package/dist/domains/eval/standalone-static-collect.js.map +1 -0
  293. package/dist/domains/eval/user-environment.d.ts +6 -0
  294. package/dist/domains/eval/user-environment.d.ts.map +1 -0
  295. package/dist/domains/eval/user-environment.js +73 -0
  296. package/dist/domains/eval/user-environment.js.map +1 -0
  297. package/dist/domains/integrations/openspec.d.ts +1 -1
  298. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  299. package/dist/domains/integrations/openspec.js +87 -44
  300. package/dist/domains/integrations/openspec.js.map +1 -1
  301. package/dist/domains/integrations/superpowers.d.ts +14 -1
  302. package/dist/domains/integrations/superpowers.d.ts.map +1 -1
  303. package/dist/domains/integrations/superpowers.js +93 -5
  304. package/dist/domains/integrations/superpowers.js.map +1 -1
  305. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  306. package/dist/domains/skill/platform-inspect.js +3 -3
  307. package/dist/domains/skill/platform-inspect.js.map +1 -1
  308. package/dist/domains/skill/platform-install.d.ts +4 -2
  309. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  310. package/dist/domains/skill/platform-install.js +16 -10
  311. package/dist/domains/skill/platform-install.js.map +1 -1
  312. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  313. package/dist/domains/skill/project-instructions.js +11 -3
  314. package/dist/domains/skill/project-instructions.js.map +1 -1
  315. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  316. package/dist/domains/skill/uninstall.js +39 -29
  317. package/dist/domains/skill/uninstall.js.map +1 -1
  318. package/dist/domains/workflow-contract/contained-atomic-write.d.ts.map +1 -1
  319. package/dist/domains/workflow-contract/contained-atomic-write.js +18 -10
  320. package/dist/domains/workflow-contract/contained-atomic-write.js.map +1 -1
  321. package/dist/domains/workflow-contract/hook-write-policy.d.ts +9 -0
  322. package/dist/domains/workflow-contract/hook-write-policy.d.ts.map +1 -0
  323. package/dist/domains/workflow-contract/hook-write-policy.js +52 -0
  324. package/dist/domains/workflow-contract/hook-write-policy.js.map +1 -0
  325. package/dist/domains/workflow-contract/index.d.ts +2 -0
  326. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  327. package/dist/domains/workflow-contract/index.js +1 -0
  328. package/dist/domains/workflow-contract/index.js.map +1 -1
  329. package/dist/domains/workflow-contract/project-config.d.ts +4 -2
  330. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  331. package/dist/domains/workflow-contract/project-config.js +174 -2
  332. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  333. package/dist/domains/workflow-contract/protected-project-path.d.ts +13 -0
  334. package/dist/domains/workflow-contract/protected-project-path.d.ts.map +1 -1
  335. package/dist/domains/workflow-contract/protected-project-path.js +83 -0
  336. package/dist/domains/workflow-contract/protected-project-path.js.map +1 -1
  337. package/dist/domains/workflow-contract/types.d.ts +13 -0
  338. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  339. package/dist/platform/fs/strip-bom.d.ts +10 -0
  340. package/dist/platform/fs/strip-bom.d.ts.map +1 -0
  341. package/dist/platform/fs/strip-bom.js +12 -0
  342. package/dist/platform/fs/strip-bom.js.map +1 -0
  343. package/dist/platform/install/platforms.d.ts +11 -0
  344. package/dist/platform/install/platforms.d.ts.map +1 -1
  345. package/dist/platform/install/platforms.js +49 -2
  346. package/dist/platform/install/platforms.js.map +1 -1
  347. package/dist/platform/paths/git-worktree.d.ts +7 -1
  348. package/dist/platform/paths/git-worktree.d.ts.map +1 -1
  349. package/dist/platform/paths/git-worktree.js +28 -7
  350. package/dist/platform/paths/git-worktree.js.map +1 -1
  351. package/dist/platform/process/external-command.d.ts +1 -0
  352. package/dist/platform/process/external-command.d.ts.map +1 -1
  353. package/dist/platform/process/external-command.js +2 -1
  354. package/dist/platform/process/external-command.js.map +1 -1
  355. package/eval/.env.example +115 -0
  356. package/eval/README.md +237 -14
  357. package/eval/langfuse/.env.example +9 -0
  358. package/eval/langfuse/tests/conftest.py +146 -0
  359. package/eval/langfuse/tests/tasks/test_tasks.py +109 -0
  360. package/eval/langfuse/tests/test_adapter.py +272 -0
  361. package/eval/langsmith/.env.example +16 -0
  362. package/eval/langsmith/tests/conftest.py +10 -1
  363. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +4 -2
  364. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -2
  365. package/eval/local/tests/conftest.py +719 -83
  366. package/eval/local/tests/scaffold/fixtures/custom-agent/adapter.yaml +19 -0
  367. package/eval/local/tests/scaffold/test_agents.py +76 -0
  368. package/eval/local/tests/scaffold/test_aligned_comparison.py +70 -0
  369. package/eval/local/tests/scaffold/test_auto_tasks.py +350 -0
  370. package/eval/local/tests/scaffold/test_conftest_helpers.py +324 -18
  371. package/eval/local/tests/scaffold/test_custom_agents.py +174 -0
  372. package/eval/local/tests/scaffold/test_eval_context.py +217 -0
  373. package/eval/local/tests/scaffold/test_execution.py +364 -0
  374. package/eval/local/tests/scaffold/test_inline_tasks.py +56 -0
  375. package/eval/local/tests/scaffold/test_langfuse_trajectory.py +263 -0
  376. package/eval/local/tests/scaffold/test_langsmith_conftest.py +63 -0
  377. package/eval/local/tests/scaffold/test_logging.py +162 -0
  378. package/eval/local/tests/scaffold/test_manifest_tasks.py +76 -0
  379. package/eval/local/tests/scaffold/test_manifests.py +396 -0
  380. package/eval/local/tests/scaffold/test_native_aligned_eval.py +17 -0
  381. package/eval/local/tests/scaffold/test_profiles.py +64 -6
  382. package/eval/local/tests/scaffold/test_task_resolution.py +212 -0
  383. package/eval/local/tests/scaffold/test_utils.py +480 -4
  384. package/eval/local/tests/tasks/test_tasks.py +216 -14
  385. package/eval/pyproject.toml +5 -0
  386. package/eval/scaffold/__init__.py +6 -0
  387. package/eval/scaffold/docker/agent-overlay.Dockerfile +41 -0
  388. package/eval/scaffold/python/__init__.py +128 -20
  389. package/eval/scaffold/python/agents.py +239 -0
  390. package/eval/scaffold/python/aligned_comparison.py +156 -27
  391. package/eval/scaffold/python/auto_tasks.py +700 -0
  392. package/eval/scaffold/python/custom_agents.py +172 -0
  393. package/eval/scaffold/python/eval_context.py +236 -0
  394. package/eval/scaffold/python/eval_schema.py +135 -0
  395. package/eval/scaffold/python/execution.py +544 -0
  396. package/eval/scaffold/python/generated_task_cache.py +230 -0
  397. package/eval/scaffold/python/generic_llm_judge.py +41 -14
  398. package/eval/scaffold/python/inline_tasks.py +118 -0
  399. package/eval/scaffold/python/judge_config.py +158 -37
  400. package/eval/scaffold/python/langfuse_adapter.py +1023 -0
  401. package/eval/scaffold/python/llm_judge.py +68 -11
  402. package/eval/scaffold/python/logging.py +157 -17
  403. package/eval/scaffold/python/manifest_tasks.py +69 -0
  404. package/eval/scaffold/python/manifests.py +443 -22
  405. package/eval/scaffold/python/paths.py +11 -1
  406. package/eval/scaffold/python/task_resolution.py +176 -0
  407. package/eval/scaffold/python/tasks.py +17 -4
  408. package/eval/scaffold/python/utils.py +167 -11
  409. package/eval/scaffold/python/validation/core.py +48 -2
  410. package/eval/scaffold/python/validation/generic_rubric.py +9 -0
  411. package/eval/scaffold/python/validation/native_workflow.py +6 -1
  412. package/eval/scaffold/python/validation/rubric.py +16 -1
  413. package/eval/scaffold/shell/agent-runtime-config.sh +88 -0
  414. package/eval/scaffold/shell/docker.sh +534 -33
  415. package/eval/scaffold/shell/run-agent-runtime.sh +49 -0
  416. package/eval/scaffold/shell/run-claude-loop.sh +153 -14
  417. package/eval/schemas/comet.eval/v1alpha1.schema.json +244 -0
  418. package/package.json +18 -28
  419. package/dist/domains/dashboard/web/assets/arc-CkuYweSh.js +0 -1
  420. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR--tTGrKam.js +0 -36
  421. package/dist/domains/dashboard/web/assets/blockDiagram-GPEHLZMM-DLKYOixs.js +0 -132
  422. package/dist/domains/dashboard/web/assets/channel-Cg__FSMr.js +0 -1
  423. package/dist/domains/dashboard/web/assets/chunk-AQP2D5EJ-BUkV_rb7.js +0 -231
  424. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CsC-pvu9.js +0 -1
  425. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CsC-pvu9.js +0 -1
  426. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-DeOQo7bP.js +0 -4
  427. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-IQd_jQwB.js +0 -43
  428. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-Dllkdt0m.js +0 -10
  429. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-DK36WkNN.js +0 -24
  430. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-iqUnMYEh.js +0 -24
  431. package/dist/domains/dashboard/web/assets/erDiagram-TEJ5UH35-Bc64lzy8.js +0 -85
  432. package/dist/domains/dashboard/web/assets/flowDiagram-I6XJVG4X-UfOqef9j.js +0 -162
  433. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-D-u6Aauc.js +0 -292
  434. package/dist/domains/dashboard/web/assets/index-BFwKBVTJ.css +0 -1
  435. package/dist/domains/dashboard/web/assets/index-COZ_03uK.js +0 -257
  436. package/dist/domains/dashboard/web/assets/layout-SsrduOYp.js +0 -1
  437. package/dist/domains/dashboard/web/assets/mermaid.core-COBBjtVH.js +0 -301
  438. package/dist/domains/dashboard/web/assets/pieDiagram-4H26LBE5-CJro_XKk.js +0 -30
  439. package/dist/domains/dashboard/web/assets/purify.es-VaSPOPhr.js +0 -3
  440. package/dist/domains/dashboard/web/assets/sankeyDiagram-5OEKKPKP-Wx60WwHe.js +0 -40
  441. package/dist/domains/dashboard/web/assets/sequenceDiagram-3UESZ5HK-BiMsRFbc.js +0 -162
  442. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-BrURMY0R.js +0 -1
  443. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-BpEE-yEg.js +0 -1
  444. package/dist/domains/dashboard/web/assets/vennDiagram-CIIHVFJN-DGB16bvR.js +0 -34
  445. package/dist/domains/dashboard/web/assets/xychartDiagram-2RQKCTM6-DMzzwDVX.js +0 -7
  446. package/eval/local/tasks/comet-native-interrupted-transition/environment/.comet/config.yaml +0 -6
@@ -22,17 +22,36 @@ Every prompt and artifact request passed to OpenSpec must include the resolved C
22
22
 
23
23
  When resuming an existing change, inspect `<classic-change-dir>/.comet.yaml` first:
24
24
 
25
- - If it exists and parses, select the change as the first state operation
26
- - If it is missing but the change directory is valid, run `comet state init <change-name> full`, then select the change
25
+ - If it exists and parses, first run `comet classic workspace resolve <change-name> --json`, enter the returned `projectRoot`, then select the change
26
+ - If it is missing but the change directory is valid, first prepare the workspace with the selected isolation mode, then run `comet state init <change-name> full --isolation <selected-isolation>` from the returned `projectRoot`, and select the change
27
27
  - If it is malformed, stop and report the parse error; repair it manually from version control, a backup, or verifiable artifacts before continuing, and never overwrite a damaged file with `state set`
28
28
 
29
29
  ```bash
30
+ comet classic workspace resolve <change-name> --json
31
+ # enter the returned projectRoot
30
32
  comet state select <change-name>
31
33
  ```
32
34
 
33
35
  When creating a new change, initialize `.comet.yaml` first, then immediately run the same command; never fabricate a selection before state exists.
34
36
 
35
- ### 0b. OpenSpec Compatibility Check
37
+ ### 0b. Workspace Decision and Preparation Before Open
38
+
39
+ Read `comet-classic/reference/workspace.md` when creating a Classic change. The workspace decision must be completed before creating OpenSpec artifacts or `.comet.yaml`; it must not be deferred to Build:
40
+
41
+ - When parallel intent is explicit, use `worktree` directly so the independent workspace is ready before OpenSpec and state creation
42
+ - When isolation is not specified, follow the reference: show the valid `current`, `branch`, and `worktree` choices when a decision is needed, and make the recommendation explanatory only
43
+ - A user-selected `current` or `branch` remains a serial choice; do not describe it as safe for simultaneous sessions
44
+
45
+ Prepare a new change before running OpenSpec `new`:
46
+
47
+ ```bash
48
+ comet classic workspace prepare <name> --isolation <current|branch|worktree> --json
49
+ # enter the returned projectRoot; all later OpenSpec, state, and artifact writes run there
50
+ ```
51
+
52
+ The preparation command reuses a registered Worktree whose branch matches the change. If the branch still exists but its registered Worktree was removed, it recreates the Worktree. Ask for an explicit rebind only when the branch was renamed, taken over, or ownership is ambiguous.
53
+
54
+ ### 0c. OpenSpec Compatibility Check
36
55
 
37
56
  Before any OpenSpec status or instructions command, run:
38
57
 
@@ -145,7 +164,7 @@ Use the Step 1b resolved brief directly to populate artifact content. Fall back
145
164
  Immediately after creating the change skeleton, initialize recoverable state instead of waiting until every artifact is generated:
146
165
 
147
166
  ```bash
148
- comet state init <name> full
167
+ comet state init <name> full --isolation <selected-isolation>
149
168
  comet state select <name>
150
169
  comet state check <name> open
151
170
  ```
@@ -206,7 +225,7 @@ Proceed to Step 4 after verification passes. The script outputs specific failure
206
225
 
207
226
  **Idempotent recovery algorithm**: all open phase operations can be safely re-executed. On recovery, process the status in this order:
208
227
 
209
- 1. If state is missing, run `comet state init <name> full`; if malformed, stop and repair it instead of overwriting it. Then select the change and run `comet state check <name> open`.
228
+ 1. If state is missing, first prepare the workspace with the selected isolation mode, then run `comet state init <name> full --isolation <selected-isolation>` from the returned `projectRoot`; if malformed, stop and repair it instead of overwriting it. Then select the change and run `comet state check <name> open`.
210
229
  2. Run status and revalidate `changeRoot`, core ids, `applyRequires`, `artifacts`, and `missingDeps`.
211
230
  3. `done`: keep the artifact unchanged and do not regenerate it.
212
231
  4. `ready`: fetch its instructions, write the returned output, and immediately rerun status.
@@ -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
 
@@ -80,16 +87,16 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
80
87
 
81
88
  无需手动更新 phase,阶段守卫(guard `--apply`)会在退出条件满足后推进 `phase` 字段。
82
89
 
83
- 展示联合决策时,提供本工作流支持的全部工作区隔离和执行方式。用户选择后直接执行对应动作;若动作实际失败,停止并报告原错误。某个字段只剩一个工作流合法值时说明原因并直接采用,不为单选项制造额外停顿。
90
+ 展示联合决策时,只提供本工作流支持的执行方式、TDD 模式和代码审查模式。工作区已经在 Open 阶段准备并绑定;若当前 change 没有有效 isolation,返回 `/comet-open` 修复,不在 Build 创建或切换工作区。
84
91
 
85
- 计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、工作区隔离、执行方式、TDD 模式和代码审查模式。选择 `branch` 时,分支名也必须在 Step 2 的同一个联合决策中确认或由用户覆盖。不得先询问“继续/暂停”,继续后又创建第二个配置或命名阻塞点。
92
+ 计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、执行方式、TDD 模式和代码审查模式。不得先询问“继续/暂停”,继续后又创建第二个配置阻塞点。
86
93
 
87
94
  | 选项 | 行为 | 说明 |
88
95
  |------|------|------|
89
- | A | 继续执行并提交配置 | 在同一次回复中选择 Step 3 的隔离、执行、TDD 和审查配置;如选择 branch,同时提交分支名 |
96
+ | A | 继续执行并提交配置 | 在同一次回复中选择 Step 3 的执行、TDD 和审查配置 |
90
97
  | B | 暂停切换模型 | 记录 `build_pause: plan-ready`,本次 `/comet-build` 停止,用户稍后可从 `/comet-classic` 或 `/comet-build` 恢复 |
91
98
 
92
- 这是用户决策点。**必须按 `comet-classic/reference/decision-point.md` 的协议一次性展示计划摘要、暂停选项和 Step 3 全部可执行配置**。用户选择继续时,必须在同一回复中给出所有配置以及条件性的分支名;不得自动选择,也不得把暂停写入 `build_mode`。
99
+ 这是用户决策点。**必须按 `comet-classic/reference/decision-point.md` 的协议一次性展示计划摘要、暂停选项和 Step 3 全部可执行配置**。不得自动选择,也不得把暂停写入 `build_mode`。
93
100
 
94
101
  用户选择继续并给出完整配置时:
95
102
 
@@ -113,22 +120,15 @@ comet state set <name> build_pause plan-ready
113
120
  comet state set <name> build_pause null
114
121
  ```
115
122
 
116
- 然后应用本步骤中的工作区隔离、执行方式、TDD 模式和代码审查模式。
123
+ 然后应用本步骤中的执行方式、TDD 模式和代码审查模式。
117
124
 
118
- 计划已写入当前分支。以下配置必须由 Step 2 的联合决策一次性确认:
125
+ 计划已写入 Open 阶段准备好的工作区。先确认已有绑定:
119
126
 
120
- **工作区隔离**:
121
-
122
- | 选项 | 方式 | 说明 |
123
- |------|------|------|
124
- | A | 当前分支直接工作 | 不创建新分支,如实绑定当前 Git 分支 |
125
- | B | 创建分支 | 在当前仓库创建新分支,简单快速 |
126
- | C | 创建 Worktree | 隔离工作区,完全独立,适合并行开发 |
127
+ ```bash
128
+ comet state get <name> isolation
129
+ ```
127
130
 
128
- **推荐规则**:
129
- - 用户明确希望沿用当前分支,或当前分支本身就是该 change 的目标分支 → 推荐 A
130
- - 变更涉及 ≤ 3 个文件且当前分支干净 → 推荐 B
131
- - 需要并行开发、当前分支有未提交工作 → 推荐 C
131
+ 如果结果为空,停止 Build 并返回 `/comet-open` 执行 workspace resolve/prepare;不得在本步骤首次选择或创建 current、branch、worktree。
132
132
 
133
133
  **执行方式**:
134
134
 
@@ -142,13 +142,9 @@ comet state set <name> build_pause null
142
142
  - 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
143
143
  - 来自 hotfix 路径 → 推荐 B
144
144
 
145
- 这些表格是 Step 2 联合决策的一部分,不再单独暂停。始终展示本工作流支持的隔离和执行选项,不得因预判某个动作会失败而移除选项。在多个合法选项时,不得根据推荐规则自行选择 `current`、`branch` 或 `worktree`,也不得自行选择执行方式、TDD 模式或代码审查模式。推荐规则只能用于说明建议,不能替代用户确认。
145
+ 执行方式、TDD 和审查表格是 Step 2 联合决策的一部分,不再单独暂停。不得用推荐规则替代用户确认。
146
146
 
147
- 用户选择后,更新 `isolation`、执行方式、TDD 模式和代码审查模式相关字段:
148
-
149
- ```bash
150
- comet state set <name> isolation <current|branch|worktree>
151
- ```
147
+ 用户选择后,只更新执行方式、TDD 模式和代码审查模式相关字段;保留 Open 阶段已绑定的 `isolation` 和 `bound_branch`。
152
148
 
153
149
  - 若用户选择 `executing-plans`:运行 `comet state set <name> subagent_dispatch null`,再运行 `comet state set <name> build_mode executing-plans`
154
150
  - 若用户选择 `subagent-driven-development`:先运行 `comet state set <name> subagent_dispatch confirmed` 记录已选择子代理执行,再运行 `comet state set <name> build_mode subagent-driven-development`
@@ -172,7 +168,7 @@ comet state set <name> isolation <current|branch|worktree>
172
168
 
173
169
  运行 `comet state set <name> review_mode <off|standard|thorough>`
174
170
 
175
- `isolation` 是脚本级硬约束。full workflow 初始化时可以为 `null`,但只允许存在到本步骤之前。若保持 `null`,`build → verify` 的 guard 和 `comet state transition build-complete` 都会失败。full workflow 允许 `current`、`branch` 或 `worktree`,但 `current` 必须通过用户在 Step 2 显式选择后写入,不得静默默认。
171
+ `isolation` 是脚本级硬约束。full workflow 必须在 Open 阶段写入 `current`、`branch` 或 `worktree`,并在进入 Build 前完成对应 workspace 准备和 `bound_branch` 绑定;若缺失,Build 只能停止并返回 Open 修复。
176
172
 
177
173
  `subagent_dispatch` 是脚本级硬约束,用于记录用户已选择子代理执行。`build_mode: subagent-driven-development` 离开 build 阶段前必须同时满足 `subagent_dispatch: confirmed`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败;它不是能力检查。
178
174
 
@@ -189,39 +185,9 @@ comet state set <name> build_mode direct
189
185
 
190
186
  没有 `direct_override: true` 时,full workflow 的 `build_mode=direct` 会被 guard 和状态转换同时拦截。
191
187
 
192
- **执行隔离**:
193
-
194
- - **current**:不创建新分支或 worktree,直接在当前 Git 分支执行。立即运行 `comet state set <name> isolation current`;该命令会把当前分支写入 `bound_branch`。如果当前是 detached HEAD,必须停止并让用户先切回真实分支,因为没有可审计的绑定分支。
195
-
196
- - **branch**:使用 Step 2 已确认的分支名,不得再次暂停。若旧状态恢复时缺少该次联合决策中的分支名,重新进入 Step 2 的同一个联合决策;不得创建第二个独立分支命名决策点。
197
-
198
- 分支命名规范:
199
- - 读取 `.comet.yaml` 的 `workflow` 字段确定前缀
200
- - `workflow: full` → 推荐 `feature/YYYYMMDD/<change-name>`
201
- - `workflow: hotfix` → 推荐 `hotfix/YYYYMMDD/<change-name>`
202
- - `workflow: tweak` → 推荐 `tweak/YYYYMMDD/<change-name>`
203
- - 日期取当前运行环境日期并格式化为 `YYYYMMDD`,不得依赖某一种 shell 的日期命令
204
-
205
- 示例:如果 change 名称为 `fix-login-bug`,今天是 2026-06-09,则推荐 `feature/20260609/fix-login-bug`
206
-
207
- 分支名由 Step 2 确认后,立即执行 `git checkout -b <branch-name>`,然后运行 `comet state set <name> isolation branch`,把新分支写入 `bound_branch`。后续工作在新分支上进行。
188
+ **执行位置**:
208
189
 
209
- - **worktree**:**立即执行:** 使用 Skill 工具加载 Superpowers `using-git-worktrees` 技能创建隔离工作区。禁止用普通 shell 命令或原生工具绕过该技能;若加载时因不可用而失败,停止并报告该错误。
210
-
211
- 创建隔离后,确认计划文件可访问(分支方式天然可访问;worktree 方式需确认计划已提交)。若 worktree 模式下计划文件尚未提交,先提交计划文件再创建 worktree:
212
-
213
- ```bash
214
- git add docs/superpowers/plans/YYYY-MM-DD-feature.md
215
- git commit -m "chore: add implementation plan"
216
- ```
217
-
218
- 进入最终执行分支或 worktree 后,必须在该实际工作区重新绑定当前 change。branch 模式已在切换后通过 `isolation branch` 绑定;worktree 模式必须在新工作区运行 `comet state set <name> isolation worktree`,把 worktree 的当前分支写入 `bound_branch`。新 worktree 不会继承原工作区的本地选择文件,因此还必须选择当前 change:
219
-
220
- ```bash
221
- comet state select <change-name>
222
- ```
223
-
224
- 重新绑定成功后才能开始源码写入。
190
+ Open 阶段已经根据 `isolation` 准备好当前目录、分支或 Worktree,并返回了实际 `projectRoot`。恢复时先运行 `comet classic workspace resolve <name> --json`,进入返回目录,再运行 `comet state select <change-name>`;不得在 Build 再创建 Worktree、切换分支、提交计划以跨 Worktree 传递,或重新绑定 isolation。
225
191
 
226
192
  **执行计划**:必须按 `build_mode` 的真实运行位置处理。
227
193
 
@@ -281,6 +247,14 @@ comet state select <change-name>
281
247
  - 不提前同步到 main spec,归档时统一同步
282
248
  - 小规模增量直接改 delta spec 时,应在 commit message 中注明,便于归档时判断 design doc 漂移
283
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
+
284
258
  ### 5. 上下文管理
285
259
 
286
260
  Build 是最长阶段,可能跨越大量任务。为支持上下文压缩后断点恢复:
@@ -45,9 +45,13 @@ agent 做决策只需读本节,参考附录按需查阅。
45
45
  当 runtime route、Ambient Resume 或用户选择已经解析出明确 change 后,进入对应阶段 Skill 前必须先绑定当前执行上下文:
46
46
 
47
47
  ```bash
48
+ comet classic workspace resolve <change-name> --json
49
+ # 进入返回的 projectRoot;state select 会在该工作区写入选择
48
50
  comet state select <change-name>
49
51
  ```
50
52
 
53
+ 新 change 的 workspace 决策在 `/comet-open` 完成,并遵循 `comet-classic/reference/workspace.md`:用户明确表达并行、同时处理或多个会话时,在绑定前准备 Worktree;未指定隔离方式时,需要决策就把 `current`、`branch`、`worktree` 作为单选项展示,推荐只作说明。准备和恢复都会扫描已登记 Worktree,优先复用分支匹配的工作区;当分支已重命名、被用户接管或无法确认归属时请求 rebind。
54
+
51
55
  多个 active change 且用户尚未明确选择时,不得提前绑定;继续按 `ask_user` 决策点等待选择。
52
56
 
53
57
  ### Comet Ambient Resume
@@ -131,7 +135,8 @@ comet resume-probe . --stdin --json
131
135
  - 若 `build_pause: plan-ready` 但 `isolation`、`build_mode`、`tdd_mode` 和 `review_mode` 都已经设置,则视为 stale pause:先输出 `[COMET] 检测到 stale pause(build_pause=plan-ready 但 isolation/build_mode/tdd_mode/review_mode 已设置),自动清除并继续`,再运行 `comet state set <name> build_pause null`,然后读取 tasks.md 的下一个未勾选任务并按 `build_mode` 恢复执行
132
136
  - 若 `build_pause: plan-ready` 且 plan 文件存在,但 `isolation`、`build_mode`、`tdd_mode` 或 `review_mode` 尚未设置,回到 `/comet-build` 的 plan-ready 恢复点,提示用户继续补齐/确认工作区隔离、执行方式、TDD 模式和代码审查模式,不重新生成 plan
133
137
  - 若 `build_pause: plan-ready` 但 plan 文件缺失,回到 `/comet-build` 处理状态损坏或重新生成 plan
134
- - 若 `isolation`、`build_mode`、`tdd_mode` 或 `review_mode` 未设置,回到 `/comet-build` 对应步骤补充后再执行
138
+ - 若旧 change 的 `isolation` 未设置,先回到 `/comet-open` 执行 workspace resolve/prepare;不得在 Build 首次决定工作区
139
+ - 若 `build_mode`、`tdd_mode` 或 `review_mode` 未设置,回到 `/comet-build` 对应步骤补充后再执行
135
140
  - 若均已设置,读取 tasks.md 的下一个未勾选任务,并按 `build_mode` 恢复执行:
136
141
  - 若 `build_mode: subagent-driven-development`,不得在主窗口直接执行任务;必须回到 `/comet-build` 的后台 subagent 调度规则,由主窗口只做协调
137
142
  - 其他执行方式按 `/comet-build` 的对应规则继续
@@ -194,13 +199,14 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
194
199
  1. workflow 目标选择:多个 active changes、继续现有 change/创建新 change、或批量拆分完成后选择先启动哪一个
195
200
  2. open 阶段 proposal/design/tasks 最终审视确认(同时确认 change 名称与范围;清晰请求不做前置摘要/命名确认)
196
201
  3. brainstorming 确认设计方案
197
- 4. build 阶段一次性联合选择 plan-ready 暂停或完整工作方式(工作区隔离 + 执行方式 + TDD 模式 + 代码审查模式;选择 branch 时同时确认分支名)
198
- 5. verify 阶段接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移,或第 4 次失败后选择继续修复/停止;前 3 次明确可修复失败自动闭环
199
- 6. archive 阶段执行归档脚本前的最终确认
200
- 7. 归档改动精确提交后选择 finishing-branch 分支处理方式
201
- 8. 遇到升级判定信号(hotfix/tweak → 用户二选一:继续预设流程 / 升级完整流程)
202
- 9. build 阶段范围扩张需重新设计或拆分新 change
203
- 10. open 阶段大型 PRD 是否拆分为多个 changes
202
+ 4. open 阶段工作区决策:明确并行自动使用 Worktree;未指定隔离方式且需要决策时,将合法的 `current`、`branch`、`worktree` 作为单选项展示
203
+ 5. build 阶段一次性联合选择 plan-ready 暂停、执行方式、TDD 模式和代码审查模式
204
+ 6. verify 阶段接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移,或第 4 次失败后选择继续修复/停止;前 3 次明确可修复失败自动闭环
205
+ 7. archive 阶段执行归档脚本前的最终确认
206
+ 8. 归档改动精确提交后选择 finishing-branch 分支处理方式
207
+ 9. 遇到升级判定信号(hotfix/tweak → 用户二选一:继续预设流程 / 升级完整流程)
208
+ 10. build 阶段范围扩张需重新设计或拆分新 change
209
+ 11. open 阶段大型 PRD 是否拆分为多个 changes
204
210
 
205
211
  agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须自动继续推进,不得中途退出。到达决策点时,**禁止跳过用户确认或自动选择——必须提出明确选项并获取用户选择后才能继续**。
206
212
 
@@ -47,7 +47,7 @@ archived: false
47
47
  | `subagent_dispatch` | `null` 或 `confirmed`。`confirmed` 记录用户已选择 `subagent-driven-development`;该模式只有带此记录时才能离开 build 阶段 |
48
48
  | `tdd_mode` | `tdd` 或 `direct`。full workflow 离开 build 阶段前必须已选择。`tdd` 强制每个任务先写失败测试再实现;`direct` 不强制逐任务 TDD,但仍需相关测试与 bug 回归证据。hotfix/tweak 默认 `direct` |
49
49
  | `review_mode` | `off`、`standard` 或 `thorough`。full workflow 离开 build 阶段前必须已选择;hotfix/tweak 默认 `off` |
50
- | `isolation` | `current`、`branch` 或 `worktree`。full 初始化可为 `null`,离开 build 前必须由用户显式选择 `current`、实际创建/选择 `branch`,或实际创建/选择 `worktree`;hotfix/tweak 在入口用户决策点后也可如实使用三种模式,不得在未创建分支时虚构为 `branch` |
50
+ | `isolation` | `current`、`branch` 或 `worktree`。full change 在 Open 阶段创建产物前决定工作区;hotfix/tweak 在入口决策点后也可如实使用三种模式,不得在未创建分支时虚构为 `branch` |
51
51
  | `bound_branch` | 工作区分支绑定记录,可为空。`isolation: current` / `branch` / `worktree` 首次设置或入口检查时记录命令执行目录所在的当前 Git 分支(worktree 模式请在对应工作区内执行 set/check/guard,否则会绑定/比对错误的分支);在不同工作区模式之间切换 `isolation` 会重新绑定到当前分支,重复设置同一模式保持原绑定。后续 `comet state select` / `comet state check` 必须确认绑定分支与当前分支一致;漂移时 `select` 直接拒绝、检查进入 `BLOCKED`,按决策点协议让用户选择切回绑定分支或明确确认后运行 `comet state rebind <change-name>`。清空 `isolation` 时会清空该字段 |
52
52
  | `verify_mode` | `light` 或 `full`,可为空 |
53
53
  | `auto_transition` | `true` 或 `false`。只控制阶段守卫推进 phase 后是否自动调用下一个 skill;`false` 时由 `comet-state next` 输出 `manual`,暂停下一 skill 调用,但不阻止 phase 字段更新 |
@@ -13,6 +13,8 @@
13
13
  日常工作流统一调用公开 CLI:
14
14
 
15
15
  ```bash
16
+ comet classic workspace prepare <change-name> --isolation <current|branch|worktree> --json
17
+ comet classic workspace resolve <change-name> --json
16
18
  comet state select <change-name>
17
19
  comet state current
18
20
  comet state clear-selection
@@ -24,7 +26,7 @@ comet resume-probe . --stdin --json
24
26
  comet classic intent route --stdin
25
27
  ```
26
28
 
27
- 当多个 active change 共存时,进入明确的 change 后先运行 `comet state select <change-name>`。普通源码写入只受该选择管辖;尚未选择时 hook 会阻塞并要求选择。单 active change 可继续自动归属。切换 branch/worktree 或选择失效后必须重新运行 `select`。
29
+ 在 Open 阶段先运行 workspace prepare;恢复时运行 workspace resolve,它会扫描已登记 Worktree 并返回应进入的 `projectRoot`。进入明确的 change 后再运行 `comet state select <change-name>`。普通源码写入只受该选择管辖;尚未选择时 hook 会阻塞并要求选择。切换 branch/worktree 或选择失效后必须重新运行 resolve 和 select。
28
30
 
29
31
  guard 的 `--apply` 在检查通过后推进状态。需要直接表达状态事件时使用 `comet state transition`;阶段推进后使用 `comet state next` 解析是否自动调用下一 Skill。
30
32
 
@@ -0,0 +1,23 @@
1
+ # Classic 工作区选择参考
2
+
3
+ 只在创建 change 时读取。已有 change 应使用已持久化的工作区绑定,并路由到返回的 `projectRoot`。
4
+
5
+ 用户明确表达并行、同时处理或多个会话时,直接使用 `worktree`,不再询问三种方式。未指定隔离方式且没有明确并行意图时,出现以下任一情况才询问用户:
6
+
7
+ - 当前目录有未提交工作;
8
+ - 已有其他 active Classic change;
9
+ - 用户要求并行开发或隔离工作,但没有指定方式。
10
+
11
+ 没有这些情况时使用 Runtime 默认的 `current`。
12
+
13
+ 需要询问时,把隔离方式作为一个单选决策点:
14
+
15
+ | 选项 | 方式 | 实际影响 |
16
+ | --- | --- | --- |
17
+ | A | 当前目录(`current`) | 沿用当前分支和目录,不创建新的 Git 分支或工作目录 |
18
+ | B | 新分支(`branch`) | 在当前目录切换到新的 change 分支;要求当前工作区干净 |
19
+ | C | 新 worktree(`worktree`) | 创建或复用独立分支和工作目录,适合并行 change 或当前目录已有未提交工作 |
20
+
21
+ 展示与当前状态和用户要求一致的全部合法选项,不因预判后续命令可能失败而额外筛选。用户明确要沿用当前分支时推荐 A;需要独立分支且无需并行工作时推荐 B;需要并行开发、当前目录已有工作,或已有 active Classic change 时推荐 C。
22
+
23
+ 推荐只作说明,等待用户选择后再创建。已有 change 分支如果已经登记在 Worktree 中,Runtime 会复用它;如果分支仍存在但登记的 Worktree 已被移除,Runtime 会重建它。只有分支已重命名、被用户接管或归属无法确认时,才按恢复协议请求 rebind。提问方式遵循[澄清参考](decision-point.md):优先使用结构化单选工具;工具不可用时使用编号文本并暂停等待。只有一个合法选项时,说明原因并直接采用。
@@ -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
 
@@ -6,30 +6,26 @@ description: "Comet Native 工作流。当用户明确调用 /comet-native、要
6
6
  # Comet Native
7
7
 
8
8
  Native 把需求、完整目标规格、当前进度和验收结论保存在项目中。每完成一个阶段都回到 Runtime 读取下一步,当前只处理 Runtime 指定的阶段。
9
-
10
9
  ## 硬性边界
11
10
 
12
11
  - 磁盘中的 `.comet/config.yaml`、当前 change、`comet-state.yaml` 和正式 Markdown 是工作依据,聊天记忆只作辅助。
13
- - Runtime 管理工作流状态、本机任务、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 `comet native` 命令完成。
12
+ - Runtime 管理工作流状态、本机任务、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 `comet native` 命令完成,用户不手工执行这些命令。
14
13
  - 命令不可用时报告 Comet 安装不完整并停止。参数和输出以 `comet native <command> --help` 为准。
15
14
  - Builder 提交候选,新的只读 Verifier subagent 或独立 Agent 任务作出验收判断。
16
15
  - Native 主流程由本 Skill 和 Runtime 完成,不依赖任何外部 Skill。
17
-
18
16
  ## 开始或恢复
19
17
 
20
18
  1. 已知 change 名称时,直接运行 `comet native status <change-name> --details --json`;名称未知时才运行 `comet native status --json`,确定目标后再查询该 change 的详细状态。
21
19
  2. 当前阶段需要完整验收列表时才执行 `nextPageArgs` 中的分页命令;需要编辑或核对正式正文时才运行 `show` 或读取对应 brief/Spec。
22
- 3. active change 已存在时,进入返回的 `workspace.projectRoot` 并 `select`。多个合理候选才让用户选择。
20
+ 3. active change 已存在时,进入返回的 `workspace.projectRoot` 并 `select`。Runtime 会扫描已登记 Worktree,优先返回绑定分支匹配的工作区;只有多个同样匹配的候选才让用户选择。
23
21
  4. 没有对应 active change 时才创建,并使用配置指定的产物目录。
24
-
25
22
  ### 创建 change
26
23
 
27
- 先确定小写 kebab-case 名称,再按[工作区选择参考](reference/workspace.md)决定使用当前目录、创建分支还是创建 worktree。
24
+ 先确定小写 kebab-case 名称,再按[工作区选择参考](reference/workspace.md)决定使用当前目录、创建分支还是创建 worktree。用户明确说并行、同时处理或多个会话时自动选择 `worktree`,不再询问三种方式。
28
25
 
29
- CLI 会完成分支或 worktree 绑定、维护仓库本地排除规则、核对配置并创建可跨设备恢复的状态。随后进入命令返回的 `preparation.projectRoot`。
26
+ CLI 会在创建 change 前完成分支或 worktree 绑定、复用已登记的 change 分支、在分支仍存在但登记 Worktree 已移除时重建 Worktree、维护仓库本地排除规则、核对配置并创建可跨设备恢复的状态。随后进入命令返回的 `preparation.projectRoot`;后续命令不得继续在原目录执行。
30
27
 
31
28
  如果准备没有完成,保留已经创建的资源,展示 `preparation` 中的失败原因,并按 Runtime 或用户给出的恢复方向继续。
32
-
33
29
  ## 按需读取
34
30
 
35
31
  确认 phase 后只读取需要的一份 reference:
@@ -38,13 +34,16 @@ CLI 会完成分支或 worktree 绑定、维护仓库本地排除规则、核对
38
34
  - 实际编辑 brief/完整目标规格,或查看验收报告时读取[产物参考](reference/artifacts.md);
39
35
  - 正常推进时,直接执行 Runtime 在 `continuation` 中给出的命令。只有返回字段含义不清、命令输入被拒绝、无法启动 Verifier、Verifier 执行报错,或 Verifier 要求用户补充信息时,才读取[命令参考](reference/commands.md);
40
36
  - 只有任务因进程中断、换设备后本机状态缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏而无法继续时,才读取[恢复参考](reference/recovery.md)。
41
-
42
37
  ## Shape
43
38
 
44
- 先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。
39
+ 先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。用户直接提供文件、附件、链接或本地路径作为需求来源时进入源文档完整覆盖模式:完整读取并记录 `complete`、`partial` 或 `unavailable` 状态,分块读取只改变读取顺序和工作记忆管理,不改变最终覆盖集合;`brief.md` 先保存完整来源需求和覆盖状态,再提出歧义、遗漏或隐含边界问题;可执行来源单元必须同时映射到完整目标 Spec 和至少一个验收 ID,背景、非目标或已废止内容只保留归类、理由和替代关系;修正后的旧单元标为 `superseded` 并指向替代单元;`partial`、`unavailable`、未映射或未确认内容保持 `[blocking]`。仅用于排错、取证、审查或实现参考的材料不自动触发,用途不明时先澄清;摘要不能替代来源覆盖映射。
45
40
 
46
- 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。
41
+ 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。大型需求需要拆分时,在 Supervisor Change 根目录维护 `children.yaml`,用 `depends_on` 表达真实先后关系,并用 `covers` 覆盖 Supervisor Change 的可读验收索引;数组顺序只用于稳定展示和同等就绪时的优先级。新建的 v2 `children.yaml` 只索引 brief 派生的父级验收项,`acceptance_index` 保存每个 ID 的来源和完整文字;Spec 派生的细粒度检查仍由 Runtime 的完整验收矩阵验证,不要求初始 child 计划重复列出。历史 v1 文件继续按原契约接受。
47
42
 
43
+ 大型需求在最终 Shape 确认前执行一次拆分检测:只有至少两个结果可独立实现和验证、验收项能完整映射且有真实依赖/并行价值时建议 Supervisor Change 模式;目标紧耦合、反复修改同一核心区域、协调成本更高或用户要求单 change 时保持单一 Native change;需求文字长、任务条目多本身不能触发拆分。
44
+ 建议拆分时,Skill 将 `children.yaml` 草案、执行波次和验收覆盖摘要放入一次 Shape 确认;用户可确认、调整或保持单 change。确认前不得创建子 change、worktree 或派发 Agent。
45
+ 确认后,Skill 从 Runtime 的 `readyChildren` 自动派发当前可执行子 change;支持并行时同时推进,不支持并行时按顺序执行。子 change 范围严格继承父确认,出现新的用户可见决定时回到父 Shape。
46
+ 恢复 `/comet-native` 时根据 Runtime 状态继续,不重复创建已有 child 或 worktree。
48
47
  未解决问题保持 `[blocking]`;有阻塞项时不修改项目实现。完成标准:所有会影响用户可见结果的选择和未明说的假设均已处理,没有 `[blocking]`,用户明确确认目标、范围、关键决定、验收项和非目标,并且 Runtime 已进入 Build。只有用户明确确认后才使用后续指令中含 `--confirmed` 的命令推进。
49
48
 
50
49
  ## Build ↔ Verify Loop
@@ -57,10 +56,14 @@ Build 和 Verify 组成一个有界验收循环(Loop):Builder 提交候选
57
56
 
58
57
  首次实现时读取当前 brief、完整目标规格和全部验收项。如果 Verify 未通过并返回 Build,先处理 Verifier 指出的未通过项、无法继续验证的问题和失败检查;再次提交前重新核对完整规格与全部验收项,避免只修报错点而遗漏其他要求。
59
58
 
59
+ 确认一次 Supervisor Change Shape 即授权严格派生的子 change,不要求用户重复确认相同范围。Skill 只执行 Runtime continuation 返回的动作,并在每个 child 完成后重新读取 `readyChildren`,继续下一波;Supervisor Change 最后仍由 Verify 验证完整验收项。
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` 提示在 v2 `acceptance_index` 中补充实际失败的 Spec 验收文字,并在 `children.yaml` 中追加覆盖这些失败验收项的唯一 repair child,重新确认 Supervisor Change Shape 后继续。
62
+
60
63
  需求变化时先判断归属:
61
64
 
62
- - 当前需求只是实现有遗漏:从 Verify 或 Archive 使用 `--return-to-build` 回到 Build;
63
- - 用户可见行为或验收标准发生变化:回到 Shape,更新正式产物并重新确认;
65
+ - 当前需求只是实现有遗漏:从 Verify 使用 `--revise-implementation` 保留已确认需求并回到 Build;
66
+ - 用户可见行为或验收标准发生变化:从 Verify 使用 `--revise-requirements`,更新正式产物并重新确认 Shape;
64
67
  - 与当前需求无关:保留给另一个 change。
65
68
 
66
69
  用户明确补充当前范围时,按同一规则处理。
@@ -81,7 +84,7 @@ Verifier 先读取验收项、brief、完整目标 Spec、实际实现和 Runtim
81
84
 
82
85
  Verifier 保持只读。如果现有检查不足,就在 Runtime 返回的 `inputOptions.template` 中列出还需要运行哪些检查,由 Runtime 执行并把结果返回给 Verifier。
83
86
 
84
- 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`。
85
88
 
86
89
  完成标准:Runtime 已接受完整的 Verifier 结果,并明确进入 Build、Archive、等待用户(`await-user`)、阻塞(`blocked`)或完成(`done`)中的一种状态。
87
90
 
@@ -98,7 +101,7 @@ Verifier 最终必须逐项标记为通过(`passed`)、未通过(`failed`
98
101
  每次命令后只处理最新的 `continuation`:
99
102
 
100
103
  - `continue`:执行 `commandArgs`,并按模板填写 `inputOptions`;
101
- - `await-user`:等待列出的用户决定;
104
+ - `await-user`:等待列出的用户决定;如有 `commandAlternatives`,选择匹配项执行完整 `commandArgs`,保留 `--expected-state-version` 和 `--expected-action`。alternative 过期时重新读取最新 `continuation`,不得重构无 guard 命令;
102
105
  - `blocked`:先处理列出的阻塞原因或恢复动作;
103
106
  - `done`:结束。
104
107