@rpamis/comet 0.4.0-beta.14 → 0.4.0-beta.16

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 (332) hide show
  1. package/README.md +13 -1
  2. package/assets/manifest.json +1 -1
  3. package/assets/skills/comet/SKILL.md +6 -5
  4. package/assets/skills/comet/reference/subagent-dispatch.md +2 -4
  5. package/assets/skills/comet/rules/comet-phase-guard.en.md +4 -3
  6. package/assets/skills/comet/rules/comet-phase-guard.md +4 -3
  7. package/assets/skills/comet/rules/comet-workflow-guard.en.md +1 -1
  8. package/assets/skills/comet/rules/comet-workflow-guard.md +1 -1
  9. package/assets/skills/comet/scripts/comet-archive.mjs +88 -88
  10. package/assets/skills/comet/scripts/comet-guard.mjs +126 -126
  11. package/assets/skills/comet/scripts/comet-handoff.mjs +88 -88
  12. package/assets/skills/comet/scripts/comet-hook-guard.mjs +91 -89
  13. package/assets/skills/comet/scripts/comet-hook-router.mjs +124 -116
  14. package/assets/skills/comet/scripts/comet-resume-probe.mjs +72 -72
  15. package/assets/skills/comet/scripts/comet-runtime.mjs +188 -185
  16. package/assets/skills/comet/scripts/comet-state.mjs +108 -107
  17. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +97 -97
  18. package/assets/skills/comet-any/SKILL.md +1 -1
  19. package/assets/skills/comet-any/reference/authoring-subagents.md +3 -11
  20. package/assets/skills/comet-any/reference/subagents/pause-points-author.md +1 -4
  21. package/assets/skills/comet-any/reference/subagents/reference-author.md +1 -4
  22. package/assets/skills/comet-any/reference/subagents/script-author.md +1 -4
  23. package/assets/skills/comet-any/reference/subagents/skill-core-author.md +1 -4
  24. package/assets/skills/comet-any/reference/subagents/skill-reviewer.md +1 -4
  25. package/assets/skills/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  26. package/assets/skills/comet-build/SKILL.md +2 -2
  27. package/assets/skills/comet-native/SKILL.md +85 -11
  28. package/assets/skills/comet-native/reference/artifacts.md +3 -1
  29. package/assets/skills/comet-native/reference/commands.md +15 -6
  30. package/assets/skills/comet-native/reference/recovery.md +12 -1
  31. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +124 -118
  32. package/assets/skills/comet-native/scripts/comet-native-check.mjs +116 -110
  33. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +110 -110
  34. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +121 -121
  35. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +83 -83
  36. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +88 -82
  37. package/assets/skills/comet-native/scripts/comet-native-init.mjs +85 -85
  38. package/assets/skills/comet-native/scripts/comet-native-new.mjs +114 -114
  39. package/assets/skills/comet-native/scripts/comet-native-next.mjs +122 -122
  40. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +124 -116
  41. package/assets/skills/comet-native/scripts/comet-native-root.mjs +110 -110
  42. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +154 -152
  43. package/assets/skills/comet-native/scripts/comet-native-select.mjs +110 -110
  44. package/assets/skills/comet-native/scripts/comet-native-show.mjs +80 -80
  45. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +112 -112
  46. package/assets/skills/comet-native/scripts/comet-native-status.mjs +107 -107
  47. package/assets/skills-zh/comet/SKILL.md +3 -3
  48. package/assets/skills-zh/comet/reference/subagent-dispatch.md +2 -4
  49. package/assets/skills-zh/comet-any/SKILL.md +1 -1
  50. package/assets/skills-zh/comet-any/reference/authoring-subagents.md +3 -14
  51. package/assets/skills-zh/comet-any/reference/subagents/pause-points-author.md +1 -4
  52. package/assets/skills-zh/comet-any/reference/subagents/reference-author.md +1 -4
  53. package/assets/skills-zh/comet-any/reference/subagents/script-author.md +1 -4
  54. package/assets/skills-zh/comet-any/reference/subagents/skill-core-author.md +1 -4
  55. package/assets/skills-zh/comet-any/reference/subagents/skill-reviewer.md +1 -4
  56. package/assets/skills-zh/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  57. package/assets/skills-zh/comet-build/SKILL.md +2 -2
  58. package/assets/skills-zh/comet-native/SKILL.md +86 -12
  59. package/assets/skills-zh/comet-native/reference/artifacts.md +3 -1
  60. package/assets/skills-zh/comet-native/reference/commands.md +17 -8
  61. package/assets/skills-zh/comet-native/reference/recovery.md +14 -3
  62. package/bin/fast-runtime-router.js +1 -0
  63. package/dist/app/cli/index.js +1 -0
  64. package/dist/app/cli/index.js.map +1 -1
  65. package/dist/app/commands/doctor.d.ts.map +1 -1
  66. package/dist/app/commands/doctor.js +146 -39
  67. package/dist/app/commands/doctor.js.map +1 -1
  68. package/dist/app/commands/init.d.ts.map +1 -1
  69. package/dist/app/commands/init.js +43 -12
  70. package/dist/app/commands/init.js.map +1 -1
  71. package/dist/app/commands/update.d.ts.map +1 -1
  72. package/dist/app/commands/update.js +42 -9
  73. package/dist/app/commands/update.js.map +1 -1
  74. package/dist/app/commands/workflow.d.ts +1 -0
  75. package/dist/app/commands/workflow.d.ts.map +1 -1
  76. package/dist/app/commands/workflow.js +9 -2
  77. package/dist/app/commands/workflow.js.map +1 -1
  78. package/dist/domains/comet-classic/classic-evidence.d.ts.map +1 -1
  79. package/dist/domains/comet-classic/classic-evidence.js +45 -9
  80. package/dist/domains/comet-classic/classic-evidence.js.map +1 -1
  81. package/dist/domains/comet-classic/classic-hook-guard.d.ts +5 -1
  82. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  83. package/dist/domains/comet-classic/classic-hook-guard.js +104 -20
  84. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  85. package/dist/domains/comet-classic/classic-layout-initialization.d.ts +4 -3
  86. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
  87. package/dist/domains/comet-classic/classic-layout-initialization.js +13 -9
  88. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  89. package/dist/domains/comet-classic/classic-layout.d.ts +2 -11
  90. package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
  91. package/dist/domains/comet-classic/classic-layout.js +22 -28
  92. package/dist/domains/comet-classic/classic-layout.js.map +1 -1
  93. package/dist/domains/comet-classic/classic-plan-readiness.d.ts +12 -0
  94. package/dist/domains/comet-classic/classic-plan-readiness.d.ts.map +1 -0
  95. package/dist/domains/comet-classic/classic-plan-readiness.js +26 -0
  96. package/dist/domains/comet-classic/classic-plan-readiness.js.map +1 -0
  97. package/dist/domains/comet-classic/classic-project-config.d.ts +1 -0
  98. package/dist/domains/comet-classic/classic-project-config.d.ts.map +1 -1
  99. package/dist/domains/comet-classic/classic-project-config.js +13 -7
  100. package/dist/domains/comet-classic/classic-project-config.js.map +1 -1
  101. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  102. package/dist/domains/comet-classic/classic-root-command.js +6 -1
  103. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  104. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  105. package/dist/domains/comet-classic/classic-state-command.js +58 -7
  106. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  107. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  108. package/dist/domains/comet-entry/hook-adapter.js +19 -2
  109. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  110. package/dist/domains/comet-entry/hook-project-root.d.ts +3 -0
  111. package/dist/domains/comet-entry/hook-project-root.d.ts.map +1 -0
  112. package/dist/domains/comet-entry/hook-project-root.js +62 -0
  113. package/dist/domains/comet-entry/hook-project-root.js.map +1 -0
  114. package/dist/domains/comet-entry/hook-router-entry.d.ts +2 -1
  115. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  116. package/dist/domains/comet-entry/hook-router-entry.js +6 -4
  117. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  118. package/dist/domains/comet-entry/hook-router.d.ts +2 -0
  119. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  120. package/dist/domains/comet-entry/hook-router.js +45 -9
  121. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  122. package/dist/domains/comet-entry/hook-types.d.ts +1 -0
  123. package/dist/domains/comet-entry/hook-types.d.ts.map +1 -1
  124. package/dist/domains/comet-entry/project-activation.d.ts +12 -0
  125. package/dist/domains/comet-entry/project-activation.d.ts.map +1 -0
  126. package/dist/domains/comet-entry/project-activation.js +109 -0
  127. package/dist/domains/comet-entry/project-activation.js.map +1 -0
  128. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  129. package/dist/domains/comet-entry/resume-probe.js +47 -26
  130. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  131. package/dist/domains/comet-entry/types.d.ts +1 -1
  132. package/dist/domains/comet-entry/types.d.ts.map +1 -1
  133. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  134. package/dist/domains/comet-native/native-archive-command.js +43 -1
  135. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  136. package/dist/domains/comet-native/native-archive-inspection.d.ts.map +1 -1
  137. package/dist/domains/comet-native/native-archive-inspection.js +11 -0
  138. package/dist/domains/comet-native/native-archive-inspection.js.map +1 -1
  139. package/dist/domains/comet-native/native-archive-preflight.d.ts +10 -0
  140. package/dist/domains/comet-native/native-archive-preflight.d.ts.map +1 -1
  141. package/dist/domains/comet-native/native-archive-preflight.js +44 -0
  142. package/dist/domains/comet-native/native-archive-preflight.js.map +1 -1
  143. package/dist/domains/comet-native/native-change.d.ts +18 -1
  144. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  145. package/dist/domains/comet-native/native-change.js +72 -3
  146. package/dist/domains/comet-native/native-change.js.map +1 -1
  147. package/dist/domains/comet-native/native-check.d.ts.map +1 -1
  148. package/dist/domains/comet-native/native-check.js +13 -1
  149. package/dist/domains/comet-native/native-check.js.map +1 -1
  150. package/dist/domains/comet-native/native-cli-shared.d.ts +2 -2
  151. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  152. package/dist/domains/comet-native/native-cli-shared.js +24 -3
  153. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  154. package/dist/domains/comet-native/native-conflict-inspection.d.ts +3 -1
  155. package/dist/domains/comet-native/native-conflict-inspection.d.ts.map +1 -1
  156. package/dist/domains/comet-native/native-conflict-inspection.js +20 -10
  157. package/dist/domains/comet-native/native-conflict-inspection.js.map +1 -1
  158. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  159. package/dist/domains/comet-native/native-continuation.js +16 -0
  160. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  161. package/dist/domains/comet-native/native-diagnostics.d.ts +2 -0
  162. package/dist/domains/comet-native/native-diagnostics.d.ts.map +1 -1
  163. package/dist/domains/comet-native/native-diagnostics.js +43 -32
  164. package/dist/domains/comet-native/native-diagnostics.js.map +1 -1
  165. package/dist/domains/comet-native/native-evidence-storage.d.ts +6 -0
  166. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  167. package/dist/domains/comet-native/native-evidence-storage.js +24 -0
  168. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  169. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  170. package/dist/domains/comet-native/native-findings.js +36 -0
  171. package/dist/domains/comet-native/native-findings.js.map +1 -1
  172. package/dist/domains/comet-native/native-hook-guard.js +2 -2
  173. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  174. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -1
  175. package/dist/domains/comet-native/native-new-command.js +22 -7
  176. package/dist/domains/comet-native/native-new-command.js.map +1 -1
  177. package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -1
  178. package/dist/domains/comet-native/native-receipt-command.js +14 -1
  179. package/dist/domains/comet-native/native-receipt-command.js.map +1 -1
  180. package/dist/domains/comet-native/native-receipt-errors.d.ts +23 -0
  181. package/dist/domains/comet-native/native-receipt-errors.d.ts.map +1 -0
  182. package/dist/domains/comet-native/native-receipt-errors.js +9 -0
  183. package/dist/domains/comet-native/native-receipt-errors.js.map +1 -0
  184. package/dist/domains/comet-native/native-receipt-refresh.d.ts +3 -0
  185. package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -1
  186. package/dist/domains/comet-native/native-receipt-refresh.js +13 -2
  187. package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -1
  188. package/dist/domains/comet-native/native-root-move.d.ts.map +1 -1
  189. package/dist/domains/comet-native/native-root-move.js +54 -1
  190. package/dist/domains/comet-native/native-root-move.js.map +1 -1
  191. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  192. package/dist/domains/comet-native/native-snapshot.js +71 -14
  193. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  194. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  195. package/dist/domains/comet-native/native-transitions.js +74 -42
  196. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  197. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +37 -4
  198. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  199. package/dist/domains/comet-native/native-verification-receipt-runtime.js +192 -4
  200. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  201. package/dist/domains/comet-native/native-verification-runtime.d.ts +27 -1
  202. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  203. package/dist/domains/comet-native/native-verification-runtime.js +29 -6
  204. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  205. package/dist/domains/comet-native/native-workspace.d.ts +39 -3
  206. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  207. package/dist/domains/comet-native/native-workspace.js +200 -8
  208. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  209. package/dist/domains/dashboard/collector.d.ts +26 -1
  210. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  211. package/dist/domains/dashboard/collector.js +381 -1
  212. package/dist/domains/dashboard/collector.js.map +1 -1
  213. package/dist/domains/dashboard/native-adapter.d.ts +15 -0
  214. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  215. package/dist/domains/dashboard/native-adapter.js +1 -1
  216. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  217. package/dist/domains/dashboard/native-collector.d.ts +26 -1
  218. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  219. package/dist/domains/dashboard/native-collector.js +284 -5
  220. package/dist/domains/dashboard/native-collector.js.map +1 -1
  221. package/dist/domains/dashboard/server.d.ts.map +1 -1
  222. package/dist/domains/dashboard/server.js +92 -3
  223. package/dist/domains/dashboard/server.js.map +1 -1
  224. package/dist/domains/dashboard/types.d.ts +41 -1
  225. package/dist/domains/dashboard/types.d.ts.map +1 -1
  226. package/dist/domains/dashboard/verify-parser.d.ts +1 -0
  227. package/dist/domains/dashboard/verify-parser.d.ts.map +1 -1
  228. package/dist/domains/dashboard/verify-parser.js +8 -4
  229. package/dist/domains/dashboard/verify-parser.js.map +1 -1
  230. package/dist/domains/dashboard/web/assets/{arc-mNt_SS1l.js → arc-ClrSujVb.js} +1 -1
  231. package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-Bc5akVD6.js → architectureDiagram-3BPJPVTR-B4A_t84A.js} +1 -1
  232. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-C43zhVBe.js → blockDiagram-GPEHLZMM-D72u2953.js} +1 -1
  233. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-dToETarK.js → c4Diagram-AAUBKEIU-Ca5zba3N.js} +1 -1
  234. package/dist/domains/dashboard/web/assets/channel-B_u-_i2t.js +1 -0
  235. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-C0oO137R.js → chunk-2J33WTMH-CCVPBm0J.js} +1 -1
  236. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-CGms1fgI.js → chunk-4BX2VUAB-JYluRsP-.js} +1 -1
  237. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-Bugl8v6f.js → chunk-55IACEB6-DfYm7pN7.js} +1 -1
  238. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-8ATNMlBG.js → chunk-727SXJPM-CwghIMO9.js} +1 -1
  239. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-BNYjSSqU.js → chunk-AQP2D5EJ-BA_zgMXZ.js} +1 -1
  240. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-_nJAqSbe.js → chunk-FMBD7UC4-BAJLB5V6.js} +1 -1
  241. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-lyxYm5NX.js → chunk-ND2GUHAM-Bj6HWRwi.js} +1 -1
  242. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-PUMVeWpd.js → chunk-QZHKN3VN-B1kXfg5N.js} +1 -1
  243. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BpA7BPgX.js +1 -0
  244. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BpA7BPgX.js +1 -0
  245. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-DzMqjexn.js → cose-bilkent-S5V4N54A-BBrkuiAU.js} +1 -1
  246. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B67ET0eq.js → cynefin-VYW2F7L2-DlFhgQHt.js} +1 -1
  247. package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-CQPMvRLK.js → dagre-BM42HDAG-B0Bk5oiP.js} +1 -1
  248. package/dist/domains/dashboard/web/assets/{demo-BuVau32v.js → demo-DZYPLZpF.js} +2 -2
  249. package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-BRpLrFHM.js → diagram-2AECGRRQ-tvTUiBA2.js} +1 -1
  250. package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-CPGWuGrE.js → diagram-5GNKFQAL-BZfcK29q.js} +1 -1
  251. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-D2wpX2iO.js → diagram-KO2AKTUF-BQahyP-C.js} +1 -1
  252. package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-D54mAbDu.js → diagram-LMA3HP47-D5bJnW2C.js} +1 -1
  253. package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-ZGQDpSs_.js → diagram-OG6HWLK6-DTwWdzWJ.js} +1 -1
  254. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-C3qDo7sd.js → erDiagram-TEJ5UH35-BbvrdCp9.js} +1 -1
  255. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-B7hStPd9.js → flowDiagram-I6XJVG4X-DgbR7Tcc.js} +1 -1
  256. package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-IqcLFbTK.js → ganttDiagram-6RSMTGT7-wWMOA7F4.js} +1 -1
  257. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-YrMZpzUu.js → gitGraphDiagram-PVQCEYII-DCxvMAUJ.js} +1 -1
  258. package/dist/domains/dashboard/web/assets/index-Bk1o-4VO.css +1 -0
  259. package/dist/domains/dashboard/web/assets/{index-icxk8_BP.js → index-Blit0P5Z.js} +1 -1
  260. package/dist/domains/dashboard/web/assets/index-g8vyW0R_.js +257 -0
  261. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-CcIgGK_7.js → infoDiagram-5YYISTIA-9qXEkzDe.js} +1 -1
  262. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-1x3rNjGP.js → ishikawaDiagram-YF4QCWOH-Dkf5othW.js} +1 -1
  263. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-B2XiqMNP.js → journeyDiagram-JHISSGLW-C2_IkO4s.js} +1 -1
  264. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-x46cGuo3.js → kanban-definition-UN3LZRKU-BxWgu4DL.js} +1 -1
  265. package/dist/domains/dashboard/web/assets/{linear-DFLqGZWl.js → linear-Dkr6p-Ro.js} +1 -1
  266. package/dist/domains/dashboard/web/assets/{mermaid.core-g3J6BACc.js → mermaid.core-DZUcsoG4.js} +4 -4
  267. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CTdeKmcX.js → mindmap-definition-RKZ34NQL-C9xyxGfa.js} +1 -1
  268. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-C_obwjIf.js → pieDiagram-4H26LBE5-Dn67tdOF.js} +1 -1
  269. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-B6Gnfz9M.js → quadrantDiagram-W4KKPZXB-Cy6iOcxc.js} +1 -1
  270. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-nX4PObnB.js → requirementDiagram-4Y6WPE33-B_gZONhx.js} +1 -1
  271. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-QjDwwHgl.js → sankeyDiagram-5OEKKPKP-C3u-4dOk.js} +1 -1
  272. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-BEEe0j6B.js → sequenceDiagram-3UESZ5HK-Xd3ByTVF.js} +1 -1
  273. package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CXfAaBgM.js → stateDiagram-AJRCARHV-CJGHL7Up.js} +1 -1
  274. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-rKvBgr6I.js +1 -0
  275. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-BOzX2EnD.js → timeline-definition-PNZ67QCA-DvONX2YQ.js} +1 -1
  276. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-C40vhXRq.js → vennDiagram-CIIHVFJN-B-L4qWy4.js} +1 -1
  277. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-B1rm89JH.js → wardleyDiagram-YWT4CUSO-cf39WX2o.js} +1 -1
  278. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-BlMr59qK.js → xychartDiagram-2RQKCTM6-Dk1vcm3u.js} +1 -1
  279. package/dist/domains/dashboard/web/index.html +2 -2
  280. package/dist/domains/factory/package.d.ts.map +1 -1
  281. package/dist/domains/factory/package.js +7 -22
  282. package/dist/domains/factory/package.js.map +1 -1
  283. package/dist/domains/skill/hook-lifecycle.d.ts +9 -0
  284. package/dist/domains/skill/hook-lifecycle.d.ts.map +1 -0
  285. package/dist/domains/skill/hook-lifecycle.js +48 -0
  286. package/dist/domains/skill/hook-lifecycle.js.map +1 -0
  287. package/dist/domains/skill/platform-inspect.d.ts +2 -0
  288. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  289. package/dist/domains/skill/platform-inspect.js +170 -32
  290. package/dist/domains/skill/platform-inspect.js.map +1 -1
  291. package/dist/domains/skill/platform-install.d.ts +21 -1
  292. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  293. package/dist/domains/skill/platform-install.js +142 -31
  294. package/dist/domains/skill/platform-install.js.map +1 -1
  295. package/dist/domains/skill/project-hook-projection.d.ts +14 -0
  296. package/dist/domains/skill/project-hook-projection.d.ts.map +1 -0
  297. package/dist/domains/skill/project-hook-projection.js +41 -0
  298. package/dist/domains/skill/project-hook-projection.js.map +1 -0
  299. package/dist/domains/skill/project-instructions.d.ts +3 -0
  300. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  301. package/dist/domains/skill/project-instructions.js +8 -0
  302. package/dist/domains/skill/project-instructions.js.map +1 -1
  303. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  304. package/dist/domains/skill/uninstall.js +50 -11
  305. package/dist/domains/skill/uninstall.js.map +1 -1
  306. package/dist/domains/workflow-contract/global-config.d.ts +10 -0
  307. package/dist/domains/workflow-contract/global-config.d.ts.map +1 -0
  308. package/dist/domains/workflow-contract/global-config.js +117 -0
  309. package/dist/domains/workflow-contract/global-config.js.map +1 -0
  310. package/dist/domains/workflow-contract/hook-target-scope.d.ts +6 -0
  311. package/dist/domains/workflow-contract/hook-target-scope.d.ts.map +1 -0
  312. package/dist/domains/workflow-contract/hook-target-scope.js +51 -0
  313. package/dist/domains/workflow-contract/hook-target-scope.js.map +1 -0
  314. package/dist/domains/workflow-contract/index.d.ts +1 -0
  315. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  316. package/dist/domains/workflow-contract/index.js +1 -0
  317. package/dist/domains/workflow-contract/index.js.map +1 -1
  318. package/dist/domains/workflow-contract/types.d.ts +3 -0
  319. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  320. package/dist/platform/paths/git-worktree.d.ts +4 -1
  321. package/dist/platform/paths/git-worktree.d.ts.map +1 -1
  322. package/dist/platform/paths/git-worktree.js +34 -1
  323. package/dist/platform/paths/git-worktree.js.map +1 -1
  324. package/eval/local/tests/scaffold/test_utils.py +74 -0
  325. package/eval/scaffold/shell/docker.sh +5 -0
  326. package/package.json +7 -5
  327. package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +0 -1
  328. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +0 -1
  329. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +0 -1
  330. package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +0 -257
  331. package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +0 -1
  332. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +0 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: comet
3
- description: "当用户明确调用 /comet,或明确要求使用 Comet 但未指定 Native/Classic 时使用;只按项目配置加载一个永久入口。"
3
+ description: "当用户明确调用 /comet,或明确要求使用 Comet 但未指定 Native/Classic 时使用;首次使用会按全局默认配置激活项目,之后按项目配置加载一个永久入口。"
4
4
  ---
5
5
 
6
6
  # Comet 入口
@@ -12,10 +12,10 @@ description: "当用户明确调用 /comet,或明确要求使用 Comet 但未
12
12
  1. 在当前项目运行 PATH 中安装的 Comet CLI:
13
13
 
14
14
  ```text
15
- comet workflow resolve . --json
15
+ comet workflow resolve . --activate --json
16
16
  ```
17
17
 
18
- 若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整。不得搜索 Skill 文件、扫描平台配置目录或直接调用内部 bundle。CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效时,同样停止并原样说明错误,不要回退或猜测。
18
+ 若项目还没有 `.comet/config.yaml`,该命令会将全局默认配置固化到当前项目,并在项目内创建对应产物目录;后续全局默认值变化不会改写已激活项目。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整。不得搜索 Skill 文件、扫描平台配置目录或直接调用内部 bundle。CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效时,同样停止并原样说明错误,不要回退或猜测。
19
19
  2. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
20
20
  3. 只按返回的 `skill` 选择下列一个入口。必须立即使用 Skill 工具加载且只加载该入口:
21
21
  - `/comet-native` → **立即执行:** 使用 Skill 工具加载 `comet-native` 技能。禁止跳过此步骤。
@@ -30,10 +30,8 @@
30
30
 
31
31
  ### 0. 派发强制约束(关键)
32
32
 
33
- 主会话**仅负责协调**,禁止直接执行 task。主会话禁止修改源代码。协调者唯一允许的文件修改是 plan、OpenSpec task 和 subagent 进度检查点的持久化更新。不得把多个 task 打包给同一个 agent。每个 task 派发一个全新的后台 implementer agent;当 `review_mode` 需要审查或修复时,task reviewer、修复 agent 和 final reviewer 也必须分别使用全新的后台 agent:
33
+ 主会话**仅负责协调**,禁止直接执行 task。主会话禁止修改源代码。协调者唯一允许的文件修改是 plan、OpenSpec task 和 subagent 进度检查点的持久化更新。不得把多个 task 打包给同一个 agent。通过已加载的 Superpowers `subagent-driven-development` 技能,为每个 task 派发一个全新的后台 implementer agent;当 `review_mode` 需要审查或修复时,分别派发全新的 task reviewer、修复 agent 和 final reviewer:
34
34
 
35
- - **Claude Code**:对每个 implementer,以及 `review_mode` 要求的 task reviewer、修复 agent 和 final reviewer 使用 `Agent` 工具并设置 `run_in_background: true`。禁止内联执行 task,禁止错误进入需要预先创建 team 的团队模式。
36
- - **其他平台**:使用 agent / Task / 多 agent 派发机制,并按其调度、上下文和结果返回方式执行。
37
35
  - **禁止**跨 task 或角色复用 implementer、reviewer 或修复 agent。每个 agent 拥有全新的隔离上下文,并且只接收当前角色所需的单个 task 上下文。
38
36
  - 若子代理派发操作失败,不得继续派发或由主会话代写实现;将当前任务记录为 `BLOCKED` 并写明失败原因,按当前 change 的阻塞与恢复流程处理。
39
37
 
@@ -69,7 +67,7 @@ reviewer prompt 必须保持中立:
69
67
  - 不得在 reviewer prompt 中预判、压低或禁止报告某个发现。若某个可能发现与 plan 冲突,让 reviewer 先报告,再询问用户以哪个要求为准。
70
68
  - 不得把之前 task 的累计历史粘贴进后续派发。只提供当前 task、相关接口/约束,以及已加载的 Superpowers `subagent-driven-development` 技能暴露的交接产物。
71
69
 
72
- **Model 选择**:存在 model 选择参数时,为不同角色选择合适的 model;否则直接使用默认 model。不得伪造 model 参数,也不得把缺少选择参数写成阻塞条件。可选择时,遵循 Superpowers `subagent-driven-development` 的 Model Selection 规则:
70
+ **Model 选择**:遵循 Superpowers `subagent-driven-development` 的 Model Selection 规则,为不同角色选择合适的 model:
73
71
 
74
72
  - **implementer / 修复 agent**:用 prose 描述的实现任务至少使用中档;多文件集成、需要模式匹配或调试 → 中档;需要设计判断或广泛理解代码库 → 高档。只有当 plan 文本已含完整待写代码(转写+测试),或只是单文件机械修复时,才用最便宜档。
75
73
  - **reviewer(任务级/最终)**:按 diff 大小、复杂度和风险缩放。小机械 diff 不需要最高档;微妙并发改动才上高档。
@@ -48,7 +48,7 @@ description: "仅在用户明确调用 /comet-any,或明确要求定制 /comet
48
48
  4. 展示确认页:说明每个 Node 的职责、绑定 Skill、Required Skill Call、Output Schema、可执行披露和 readiness 影响。确认页必须为每个新增 binding 或 schema 显示 enforcement:`guarded`、`handoff-guarded`、`evidence-only` 或 `advisory`。
49
49
  5. 等待用户确认:未确认前不得写 Bundle draft;存在 missing / ambiguous Skill 时必须暂停。
50
50
  6. 初始化后端状态:确认后调用 `comet creator init <name> --file <plan.json> --confirmed-proposal --json`。
51
- 7. 运行创作管线并生成 Bundle:先运行 `comet creator authoring-plan <name> --depth quick|full --json` 取得 lane DAG。按 DAG 派发 lane——wave1(`script`、`reference`、`pause-points`)在支持子代理的平台可并发(否则按依赖顺序内联),wave2(`workflow-entry`、`skill-core`)在 script 契约之后,`skill-review` 作为汇聚 barrier。每个 lane 的产出用 `comet creator authoring-record <name> --lane <id> --file <out.json> --json` 记录(经 schema 校验;BLOCKED/NEEDS_CONTEXT 会被拒绝)。随后运行 `comet creator generate <name> --json`:把记录的内容叶子草稿(entry/node SKILL.md、decision-points、recovery)合并进包,而确定性脊梁(protocol/scripts/manifest)保持模板化,并渲染真实审查证据。产出 entry Skill、Node Skills、`reference/workflow-protocol.json`、六个 scripts、rules、hooks 与 `comet/eval.yaml`。
51
+ 7. 运行创作管线并生成 Bundle:先运行 `comet creator authoring-plan <name> --depth quick|full --json` 取得 lane DAG。按 DAG 派发 lane——wave1(`script`、`reference`、`pause-points`)并发派发,wave2(`workflow-entry`、`skill-core`)在 script 契约之后并发派发,`skill-review` 作为汇聚 barrier。每个 lane 的产出用 `comet creator authoring-record <name> --lane <id> --file <out.json> --json` 记录(经 schema 校验;BLOCKED/NEEDS_CONTEXT 会被拒绝)。随后运行 `comet creator generate <name> --json`:把记录的内容叶子草稿(entry/node SKILL.md、decision-points、recovery)合并进包,而确定性脊梁(protocol/scripts/manifest)保持模板化,并渲染真实审查证据。产出 entry Skill、Node Skills、`reference/workflow-protocol.json`、六个 scripts、rules、hooks 与 `comet/eval.yaml`。
52
52
  8. 验证:展示 quick/full eval 工作量,运行或记录当前 draft hash 的 eval evidence;失败、skip 或证据 hash 过期时不得进入 ready。
53
53
  9. Review / readiness:读取 `comet publish review <name> --platform <reference-platform> --json`,展示 `Readiness:`、`Blockers:`、`Warnings:`、`Evidence:`。
54
54
  10. Publish / install preview:人工批准后才能 publish;安装前必须先运行 preview,并展示 `No files were written`。
@@ -2,18 +2,11 @@
2
2
 
3
3
  ## 核心原则
4
4
 
5
- `/comet-any` 的创作成果应由平台原生 subagent 分工产出,再交给主会话组装和后端 CLI 记录状态。
6
- Claude Code、Codex、Gemini、Copilot 等平台的 subagent 调用方式不同,本参考只定义职责、输入和输出;
7
- 具体派发方式使用当前平台提供的原生 subagent 机制。
8
-
9
- `reference/subagents/*.md` 是跨平台 lane brief;Claude Code custom agent 必须单独生成到平台 agent 资源,并带 `name`、`description`、`tools`、`model` frontmatter。不要把这些 portable lane brief 直接当作 platform-native custom agent 安装。
5
+ `/comet-any` 的创作成果由六个职责独立的 subagent 分工产出,再交给主会话组装和后端 CLI 记录状态。主会话按 authoring DAG 为每个 lane 派发全新的 subagent,并把对应的 `reference/subagents/*.md` 作为该角色的 brief。
10
6
 
11
7
  先读取本总览,再只把对应角色 brief 交给对应 subagent。不要把六个角色 brief 合并成一个大 prompt;
12
8
  主会话负责保留全局上下文、汇总成果、调用 `comet bundle` 和 `comet publish`,subagent 只产出可审查草稿。
13
9
 
14
- 平台支持 subagent 时必须调度。没有平台 subagent 能力时,主会话可以使用同一份 brief 以内联方式完成,
15
- 但必须在用户可读摘要和 `reference/authoring-lanes.json` 中标记为 fallback。
16
-
17
10
  所有 subagent 只返回 Markdown 成果和结构化审查结论,不得直接写入 Bundle state,不得执行候选 Skill 的脚本,
18
11
  不得运行发布、安装或分发命令。CLI 状态仍由主会话维护。
19
12
 
@@ -44,15 +37,13 @@ Claude Code、Codex、Gemini、Copilot 等平台的 subagent 调用方式不同
44
37
 
45
38
  上面的角色 brief 顺序只是创作 DAG 的线性展开,并非要求严格串行。权威 DAG 在 `reference/authoring-protocol.json` 与 `comet creator authoring-plan <name> --depth quick|full --json`:
46
39
 
47
- - **wave1**(`script`、`reference`、`pause-points`):彼此无依赖。在支持子代理的平台上并发派发这三个。每个只拿到自己的角色 brief、通用输入和 protocol/resolved-skills 路径(文件交接,不共享历史)。
40
+ - **wave1**(`script`、`reference`、`pause-points`):彼此无依赖,并发派发这三个。每个只拿到自己的角色 brief、通用输入和 protocol/resolved-skills 路径(文件交接,不共享历史)。
48
41
  - **wave2**(`workflow-entry`、`skill-core`):依赖 script 契约(`NEXT:`/`SKILL:` 输出)。仅在 script lane DONE 后开始。两者之间可并发。
49
42
  - **barrier**(`skill-review`):唯一同步点。仅在 wave1 与 wave2 全部 DONE 后运行;审查者必须读取所有 artifact 与 claim。
50
43
 
51
- 无论平台如何:
44
+ 派发规则:
52
45
 
53
46
  - 编排遵循 DAG 依赖;只有 barrier 真正等待此前所有 lane。
54
- - 不支持子代理的平台,主会话按依赖顺序内联执行同样的 lane——语义完全一致,仅延迟不同。在 `reference/authoring-lanes.json` 中按 lane 记录 `dispatchMode: "subagent"` 或 `"inline"`。
55
- - Claude Code 可把某个 wave 的扇出委托给其 `Workflow` 工具作为可选加速器;这是实现选择,不是契约的一部分。契约是 protocol + schemas + DAG,任何平台都能解释。
56
47
  - 每个 lane 产出在下一个依赖 wave 开始前,必须经 `comet creator authoring-record <name> --lane <id> --file <out.json> --json` 校验并记录。
57
48
 
58
49
  ## 通用输入
@@ -97,11 +88,9 @@ Claude Code、Codex、Gemini、Copilot 等平台的 subagent 调用方式不同
97
88
  ## 派发注意事项
98
89
 
99
90
  - 每次派发必须创建新的 subagent,不得继承主会话历史。主会话只提供该角色需要的 brief、输入路径和必要背景。
100
- - 必须显式指定 model;平台不支持 model 选择时,在 `reference/authoring-lanes.json` 记录为 platform-default。
101
91
  - 使用文件交接:主会话提供路径,不粘贴大段全文。通用输入、来源 Skill 摘要、草稿 artifact 和报告都应以路径交接。
102
92
  - 每个 subagent 只接收自己的角色 brief、通用输入和必要 artifact,不接收其他角色的完整 brief。
103
93
  - Skill 审查 subagent 必须在其他五个作者角色产出后运行,并读取所有 artifacts 与 claims。
104
94
  - 主会话可以要求某个角色返工,但返工结果仍必须回到 `reference/authoring-lanes.json` 和 `reference/skill-review.md`。
105
95
  - subagent 不能调用 `comet bundle`、`comet publish`、`comet skill`,也不能执行候选 Skill 的脚本。
106
96
  - 如果状态是 `BLOCKED` 或 `NEEDS_CONTEXT`,主会话必须补上下文、拆小任务、换更强模型或询问用户;不得继续组装。
107
- - 没有平台 subagent 能力时,内联 fallback 必须保留相同的 lane、claim 和 finding 结构。
@@ -1,7 +1,5 @@
1
1
  # 停顿点作者 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  设计用户在 Skill 中真正必须选择的位置,以及跨设备断点恢复方式。必须先区分四类情况:用户决策、自动处理、停止条件和手动衔接。只有存在两个或以上会改变范围、行为、风险接受或不可逆结果的合法选项时,才创建用户停顿点;单一安全动作直接执行,缺少依赖或状态损坏只报告停止条件,手动衔接只交还控制权。真正的用户决策不能被默认推荐、历史偏好或自动推进绕过。
@@ -25,11 +23,10 @@ workflow protocol 和已有草稿。
25
23
 
26
24
  ## 派发模板
27
25
 
28
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
26
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
29
27
 
30
28
  ```text
31
29
  description: "设计 <bundle-name> 的用户停顿点和恢复"
32
- model: <必须显式指定 model>
33
30
  prompt:
34
31
  你是停顿点作者 subagent。
35
32
  先读取本 brief、通用输入路径、workflow protocol 路径、Skill 草稿路径和报告文件路径。
@@ -1,7 +1,5 @@
1
1
  # reference 作者 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  编写和整理候选 Skill 的 reference 层,让审计、恢复、评审和后续维护有真实依据。
@@ -28,11 +26,10 @@ reference。
28
26
 
29
27
  ## 派发模板
30
28
 
31
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
29
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
32
30
 
33
31
  ```text
34
32
  description: "整理 <bundle-name> 的 reference 证据"
35
- model: <必须显式指定 model>
36
33
  prompt:
37
34
  你是 reference 作者 subagent。
38
35
  先读取本 brief、通用输入路径、resolved skills 路径、workflow protocol 路径和报告文件路径。
@@ -1,7 +1,5 @@
1
1
  # 脚本作者 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  设计候选 Skill 的脚本契约,而不是复制 Comet Classic 的脚本。脚本必须根据当前 workflow protocol、
@@ -29,11 +27,10 @@ artifact 的内容。
29
27
 
30
28
  ## 派发模板
31
29
 
32
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
30
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
33
31
 
34
32
  ```text
35
33
  description: "编写 <bundle-name> 的脚本契约"
36
- model: <必须显式指定 model>
37
34
  prompt:
38
35
  你是脚本作者 subagent。
39
36
  先读取本 brief、通用输入路径、workflow protocol 路径、resolved skills 路径和报告文件路径。
@@ -1,7 +1,5 @@
1
1
  # Skill 核心作者 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  编写 internal Node Skill 的用户可见核心内容。entry Skill 由 workflow entry 作者单独负责。目标是产出 Comet-like 的多 Node workflow,
@@ -70,11 +68,10 @@
70
68
 
71
69
  ## 派发模板
72
70
 
73
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
71
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
74
72
 
75
73
  ```text
76
74
  description: "编写 <bundle-name> 的 Skill 核心内容"
77
- model: <必须显式指定 model>
78
75
  prompt:
79
76
  你是 Skill 核心作者 subagent。
80
77
  先读取本 brief、通用输入路径、脚本契约路径、reference 证据路径和报告文件路径。
@@ -1,7 +1,5 @@
1
1
  # Skill 审查 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  审查其他 subagent 的 artifacts 和 claims,判断候选 Skill 是否已经像 Comet 一样可用。
@@ -21,11 +19,10 @@ claims。不得读取主会话历史来替代 artifact 证据。
21
19
 
22
20
  ## 派发模板
23
21
 
24
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
22
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
25
23
 
26
24
  ```text
27
25
  description: "审查 <bundle-name> 的 Comet-like Skill 产物"
28
- model: <必须显式指定 model>
29
26
  prompt:
30
27
  你是 Skill 审查 subagent。
31
28
  先读取本 brief、通用输入路径、五个作者报告路径、artifact 路径、claim 清单和报告文件路径。
@@ -1,7 +1,5 @@
1
1
  # Workflow Entry 作者 subagent
2
2
 
3
- 本文件是 portable lane brief,不是 platform-native custom agent;如需 Claude Code custom agent,必须另行生成平台 agent 资源和 frontmatter。
4
-
5
3
  ## 职责
6
4
 
7
5
  编写生成 Skill 的 entry `SKILL.md`。entry 只负责入口、恢复、主路由说明和用户停顿点;不得把阶段路线写成会立即触发多个 Skill 的执行清单。
@@ -40,11 +38,10 @@ Auto 区的 Node 路由表仅供参考——不要复制成执行清单,不要
40
38
 
41
39
  ## 派发模板
42
40
 
43
- 主会话派发时使用当前平台的 subagent 机制,形状应包含:
41
+ 主会话派发一个全新的对应角色 subagent,输入应包含:
44
42
 
45
43
  ```text
46
44
  description: "编写 <bundle-name> 的 workflow entry"
47
- model: <必须显式指定 model>
48
45
  prompt:
49
46
  你是 workflow entry 作者 subagent。
50
47
  先读取本 brief、通用输入路径、脚本契约路径、workflow protocol 路径和报告文件路径。
@@ -79,7 +79,7 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
79
79
 
80
80
  无需手动更新 phase,阶段守卫(guard `--apply`)会在退出条件满足后推进 `phase` 字段。
81
81
 
82
- 展示联合决策时,提供本工作流支持的全部工作区隔离和执行方式。不得预检、推断或筛除其他 Skill、分支、worktree、子代理派发或 model 选择能否使用。用户选择后直接执行对应动作;若动作实际失败,停止并报告原错误。某个字段只剩一个工作流合法值时说明原因并直接采用,不为单选项制造额外停顿。
82
+ 展示联合决策时,提供本工作流支持的全部工作区隔离和执行方式。用户选择后直接执行对应动作;若动作实际失败,停止并报告原错误。某个字段只剩一个工作流合法值时说明原因并直接采用,不为单选项制造额外停顿。
83
83
 
84
84
  计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、工作区隔离、执行方式、TDD 模式和代码审查模式。选择 `branch` 时,分支名也必须在 Step 2 的同一个联合决策中确认或由用户覆盖。不得先询问“继续/暂停”,继续后又创建第二个配置或命名阻塞点。
85
85
 
@@ -134,7 +134,7 @@ comet state set <name> build_pause null
134
134
  | 选项 | 技能 | 适用场景 |
135
135
  |------|------|---------|
136
136
  | A | Superpowers `subagent-driven-development` | 任务独立、复杂度高;每个任务在隔离的 implementer subagent 中执行,审查由 `review_mode` 驱动 |
137
- | B | Superpowers `executing-plans` | 任务简单、无子agent环境、轻量快速 |
137
+ | B | Superpowers `executing-plans` | 由主会话按计划顺序执行,适合任务较少或紧密关联的改动 |
138
138
 
139
139
  **执行方式推荐规则**:
140
140
  - 任务数 ≥ 3 → 推荐 A
@@ -15,7 +15,7 @@ Native 保存需求、完整目标规格、状态和证据。你负责理解、
15
15
  - `native.archive_confirmation`:默认 `automatic`;
16
16
  - `native.max_verify_failures`:默认 `5`。
17
17
 
18
- 磁盘中的 config、selection、change 状态和正式产物优先于聊天记忆。不要直接编辑 Runtime 管理的状态、证据、锁或事务文件。
18
+ 磁盘中的 config、当前 change 记录、change 状态和正式产物优先于聊天记忆。不要直接编辑 Runtime 管理的状态、证据、锁或事务文件。
19
19
 
20
20
  Native 主流程不依赖任何外部 Skill。
21
21
 
@@ -29,26 +29,73 @@ Native Skill 只使用 PATH 中的公开 `comet native <cmd>` CLI;随 Skill
29
29
  comet native status [--json]
30
30
  comet native show <change-name>
31
31
  comet native select <change-name>
32
- comet native new <change-name> [--language en|zh-CN]
32
+ comet native new <change-name> [--language en|zh-CN] [--isolation current|branch|worktree]
33
33
  comet native next <change-name> --summary <text> [--confirmed]
34
34
  comet native archive <change-name> --dry-run
35
35
  ```
36
36
 
37
37
  ## 开始或恢复
38
38
 
39
- 1. 运行 `comet native status`,确认当前 change 和 phase。
40
- 2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再对 status 命令加 `--details` 运行。
41
- 3. 需要更多 acceptance 时,按 `acceptancePage.nextCursor` 分页;findings 被截断时,先处理已返回项,再重新读取。
42
- 4. 确认目标后运行 `comet native select <change-name>`。
39
+ 1. 若项目使用 Git,先读取当前分支与 `git worktree list --porcelain`;对每个安全可访问的工作目录运行只读 `comet native status --project-root <path> --json`。这一步是默认发现流程,不等待用户说“并行”。
40
+ 2. 运行当前工作目录的 `comet native status`,结合其他工作目录的结果确认目标 change、所属工作目录和 phase。同名 active change 已存在时,进入其工作目录恢复,不再创建。
41
+ 3. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再对 status 命令加 `--details` 运行。
42
+ 4. 需要更多 acceptance 时,按 `acceptancePage.nextCursor` 分页;findings 被截断时,先处理已返回项,再重新读取。
43
+ 5. 进入目标实际所属的工作目录后运行 `comet native select <change-name>`;不要要求用户手动 `cd`。
43
44
 
44
- 存在多个合理候选时让用户选择。只有确认没有对应 active change 时才创建:
45
+ 存在多个合理候选时让用户选择。只有确认所有已发现工作目录中都没有对应 active change 时才创建,并执行下方工作区协议。
46
+
47
+ 只使用配置指定的 Native artifact root。
48
+
49
+ ## 新 change 的工作区协议
50
+
51
+ 并行单位是 change:不同 change 可以位于不同工作目录并行推进;同一个 change 只能由其绑定工作目录中的当前执行上下文写入,不为会话建立长期 lease。
52
+
53
+ 创建前读取当前分支、未提交改动、当前目录中的 active Native change 和已登记 Git worktree。工作方式保留三种:
54
+
55
+ - `current`:保留当前分支和目录;
56
+ - `branch`:在当前目录创建并切换到 change 分支;
57
+ - `worktree`:创建独立 change 分支和 Git 工作目录,并在其中继续。
58
+
59
+ 选择规则:
60
+
61
+ - 当前目录干净且所有已发现工作目录都没有其他 active change 时,默认直接使用 `current`,不询问“是否并行”;
62
+ - 当前目录已有未提交改动或其他事实使隔离方式会明显影响用户目录时,一次联合展示 `current / branch / worktree`,说明推荐项、分支名和工作目录;不要拆成“是否并行”等多轮问题;
63
+ - 当前目录已被另一个 active Native change 占用时,披露 `current` 和 `branch` 因 baseline 漂移风险不可用,并直接使用唯一安全的 `worktree`;其他 worktree 中的 active change 不会让本目录的 `current` 或 `branch` 自动失效;
64
+ - 用户可在同一次选择中覆盖默认分支 `comet/<change-name>` 和默认目录 `.worktrees/<change-name>`;路径或分支冲突时停止,不追加随机后缀、不接管不属于该 change 的现有目录。
65
+
66
+ `branch` 与 `worktree` 都必须在运行 `new`、建立 baseline 之前准备完成。目标分支默认绑定为创建分支或 worktree 时所在的起始分支:
45
67
 
46
68
  ```text
47
- comet native new <change-name> \
48
- --language zh-CN
69
+ # current
70
+ comet native new <change-name> --language zh-CN --isolation current
71
+
72
+ # branch:先创建并切换分支
73
+ comet native new <change-name> --language zh-CN \
74
+ --isolation branch --change-branch comet/<change-name> --target-branch <起始分支>
75
+
76
+ # worktree:先创建并进入 .worktrees/<change-name>
77
+ comet native new <change-name> --language zh-CN \
78
+ --isolation worktree --change-branch comet/<change-name> --target-branch <起始分支>
49
79
  ```
50
80
 
51
- 只使用配置指定的 Native artifact root。
81
+ 创建 worktree 前,把 `.worktrees/` 写入仓库本地 Git exclude(Git common dir 的 `info/exclude`),不得为此修改 tracked `.gitignore`。Agent 必须在新工作目录中自动继续,不把进入目录的操作交给用户。
82
+
83
+ worktree 必须从已解析的本地目标分支提交创建。源目录有未提交内容时,先归因:可证明与新 change 无关的内容留在原目录;可能属于新 change 且无法从该提交带入时,等待用户决定如何保留,不静默提交、复制或遗漏。目标目录必须从目标分支获得一致配置,或通过公开 `comet native init` 建立合法配置并核对 artifact root、language、clarification、archive、verify 与 snapshot 语义;无法证明一致时停止。不得复制源目录的 `.comet/current-change.json`。
84
+
85
+ 目标配置就绪后、运行 `new` 前,Agent 必须在新工作目录中依次执行:
86
+
87
+ ```bash
88
+ comet doctor --repair --scope project
89
+ comet doctor --scope project --json
90
+ ```
91
+
92
+ 只有 Doctor 确认 Hook runtime 为当前版本、该平台恰好存在一个以目标项目为根的 Router,且没有遗留或重复 Comet Hook 时才继续。Agent 自行在新工作目录中执行这些命令,不让用户手动进入目录;不得从源目录复制 `.comet/current-change.json`。若项目配置未从目标分支继承,则先用公开 `comet native init` 按源项目的已核对语义建立配置,再执行上述 Doctor 序列。
93
+
94
+ worktree 创建只完成部分步骤时立即停止:报告原始错误、目标分支与目标路径、已明确创建的分支/worktree/exclude/config/change 资源,以及可恢复的下一步。只能清理可证明由本次操作新建且删除安全的资源;无法证明归属时保留现场,绝不删除已有或可能属于用户的 worktree、分支与文件。
95
+
96
+ Runtime 会在 `new` 的同一个 mutation lock 中重新检查当前目录是否已出现 active change。系统默认的 `current` 因竞态返回 `workspace-isolation-required` 时,自动按默认 `worktree` 重新准备并创建;用户明确选择的方式若在执行前失效,停止并重新确认,不擅自换方式。
97
+
98
+ 没有 workspace v3 绑定的旧 active change 保持兼容:不自动生成 worktree、不移动文件、不刷新 baseline;同一旧目录内仍一次只选择一个 change。只有真实 baseline 或 scope 漂移时才按 Runtime 失败关闭,并让用户决定恢复、重建或放弃。
52
99
 
53
100
  ## 按需加载
54
101
 
@@ -110,16 +157,34 @@ comet native next <change-name> \
110
157
 
111
158
  只有 Runtime 接受完整且新鲜的验收矩阵和 required checks 时才能提交 `pass`。相关实现、规格、报告或证据改变后重新验证。
112
159
 
160
+ 提交 Verify 时只传 `--result` 和 `--report`;`next` 不接受 `--receipt` 或其他调用方提供的 required-check 参数。Runtime 会先校验报告格式、完整验收矩阵和 acceptance receipt,只有这些输入有效后才执行或复用当前 scope 的内置 required check。报告无效时先修正报告,不要反复重试同一个 `next` 命令。
161
+
113
162
  `fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next` 当作修复。`repair-stagnation-stop` 由 Agent 按恢复参考提出新假设并使用 Runtime 返回的 override;只有 continuation 要求 `repair-continuation-decision` 时才等待用户选择。
114
163
 
115
164
  Verify 失败的中间循环不运行 Archive,也不触发归档确认。持续执行 Build → Verify,直到 pass、Runtime 阻塞或需要用户决定。
116
165
 
117
166
  ## Archive
118
167
 
119
- 只有最终 Verify pass 后才预演:
168
+ 只有最终 Verify pass 后才准备 Archive。先读取该 change 的 workspace 绑定;旧 workspace 元数据按 `current` 兼容处理。
169
+
170
+ `current` 沿用 `native.archive_confirmation`,不额外询问分支收尾。`branch` 或 `worktree` 必须在 Archive 前一次联合选择:
171
+
172
+ 1. 归档并本地合并到已绑定目标分支;
173
+ 2. 归档并推送 change 分支;
174
+ 3. 归档、推送并创建 PR;
175
+ 4. 归档并保留当前分支/工作目录;
176
+ 5. 暂不归档。
177
+
178
+ 展示精确 change 分支、目标分支和工作目录;结合目标分支是否本地可用、目录是否干净给出一个推荐。只有用户选择后才执行对应外部 Git 动作;选择“暂不归档”时保留现场并停止。
179
+
180
+ 然后预演:
120
181
 
121
182
  ```text
183
+ # current
122
184
  comet native archive <change-name> --dry-run
185
+
186
+ # branch / worktree:把联合选择写入正式 workspace 元数据
187
+ comet native archive <change-name> --dry-run --finish merge|push|pull-request|keep
123
188
  ```
124
189
 
125
190
  预演成功后:
@@ -129,6 +194,15 @@ comet native archive <change-name> --dry-run
129
194
 
130
195
  不要复用旧 preflight。发生事实漂移、canonical 冲突或未完成事务时,按 continuation 和恢复参考处理。
131
196
 
197
+ Runtime 返回的 `workspaceFinish` 必须与用户选择一致;后续会话从正式 workspace 元数据恢复该决定,不重复例行询问。归档成功后,只暂存并提交已确认 change 归属的实现、规格和 Archive 路径,排除其他用户改动。此前的联合选择授权这一次精确 stage/commit 以及所选收尾动作:
198
+
199
+ - 本地合并:在已绑定目标分支的工作目录中合并 change 分支,运行与改动风险匹配的合并后验证;成功后删除干净的 change worktree 和已合并本地分支。任何失败都保留分支与工作目录;
200
+ - 推送:推送 change 分支。成功后可删除干净的 change worktree,但保留本地和远端分支;
201
+ - 推送并创建 PR:推送后以 workspace 中持久化的 `targetBranch` 作为 PR base 创建 PR,不使用仓库默认分支推断;成功后按推送方式清理;Native 不持续监控 PR;
202
+ - 保留:提交后保留分支和工作目录,不做合并或推送。
203
+
204
+ 多个 change 独立 Archive;只有更新同一个目标 ref 的本地合并需要串行。合并冲突只有在能机械地保留双方已确认契约时才可解决并重新验证;任何语义冲突都中止合并并询问是否创建新的 integration change,不把某一方静默覆盖。
205
+
132
206
  ## Continuation 与停止条件
133
207
 
134
208
  Shape、Build 和 Verify 的 transition 都会返回 `next: auto | manual`、`continuation.disposition: continue | await-user | blocked | done`、所需输入与下一步动作;Archive 不通过 `next` 推进,归档成功才返回 `done`。每次 transition 后按该 Runtime continuation 行动:
@@ -140,6 +214,6 @@ Shape、Build 和 Verify 的 transition 都会返回 `next: auto | manual`、`co
140
214
 
141
215
  `next: auto` 只表示本次 transition 成功,不表示后续步骤已执行。调用方明确要求在某次 transition 后停止时,严格按“更新正式产物 → 执行一次允许的 transition → transition 成功后不再调用工具 → 输出约定标记并结束本轮”执行;即使 continuation 为 `continue` 也不得继续执行后续步骤。
142
216
 
143
- `workspace-root-changed` 与 `workspace-inspection-unavailable` 是只读提示,不单独阻止推进或归档。未知的 workspace 完整性 finding、确定冲突、失效证据和 repair stop 必须处理;Runtime 要求修复工作区身份时,先运行只读 doctor,再按报告执行显式 `doctor --repair`。
217
+ 旧元数据的 `workspace-root-changed` 与 `workspace-inspection-unavailable` 是只读提示,不单独阻止推进或归档。`workspace-binding-root-changed`、`workspace-branch-changed`、`workspace-kind-changed` 与 `workspace-vcs-unavailable` 表示新绑定失效,必须回到绑定工作目录/分支或停止并走恢复流程。其他未知 workspace 完整性 finding、确定冲突、失效证据和 repair stop 也必须处理;Runtime 要求修复工作区身份时,先运行只读 doctor,再按报告执行显式 `doctor --repair`。
144
218
 
145
219
  摘要、理由、报告和产物中不得写入 token、密码、私钥、连接串或其他凭据。
@@ -13,7 +13,9 @@ Agent 主要编辑:
13
13
  verification.md
14
14
  ```
15
15
 
16
- 项目配置、当前 selection 和 change 状态用于读取,不要手工改变 Runtime 管理的 phase、确认、规格操作、scope、evidence、checkpoint、锁或事务字段。
16
+ 项目配置、当前 change、change 状态和 `runtime/workspace.json` 用于读取,不要手工改变 Runtime 管理的 phase、确认、规格操作、workspace 绑定、scope、evidence、checkpoint、锁或事务字段。
17
+
18
+ 新建 change 的 `comet.native.workspace.v3` 记录 `isolation`、`changeBranch`、`targetBranch`、Archive 前由 `--finish` 持久化的收尾决定和物理目录身份。它用于跨会话恢复和写入保护,不是会话 lease;旧 v1/v2 元数据保持兼容,不得为了启用隔离而手工迁移。
17
19
 
18
20
  Native artifact root 只由 `.comet/config.yaml` 指定。不要扫描其他 workflow 的目录,也不要自行创建第二个状态根。
19
21
 
@@ -46,7 +46,7 @@ comet native show <change-name>
46
46
  - `acceptancePage.nextCursor` 非空时,用 `--acceptance-cursor` 继续读取。
47
47
  - change 集合的 `nextCursor` 非空时,用 `--cursor` 继续读取。
48
48
 
49
- 这些命令都不修改 selection、phase 或 change 内容。
49
+ 这些命令都不修改当前 change、phase 或 change 内容。
50
50
 
51
51
  ### 恢复已有 change
52
52
 
@@ -54,17 +54,24 @@ comet native show <change-name>
54
54
  comet native select <change-name>
55
55
  ```
56
56
 
57
- 只在目标 change 已唯一确定或由用户明确选择后执行。`select` 只更新当前 Native selection,不改变 phase;成功结果会返回该 change 的 continuation。
57
+ 只在目标 change 已唯一确定或由用户明确选择后执行。`select` 只更新当前 Native change,不改变 phase;成功结果会返回该 change 的 continuation。
58
58
 
59
59
  选择后重新读取 `status <change-name>`,确认 phase,再加载该 phase 对应的 reference。不要把 `select` 当作阶段推进命令。
60
60
 
61
61
  ### 创建新 change
62
62
 
63
63
  ```text
64
- comet native new <change-name> [--language en|zh-CN]
64
+ comet native new <change-name> [--language en|zh-CN] \
65
+ [--isolation current|branch|worktree] \
66
+ [--change-branch <branch>] \
67
+ [--target-branch <branch>]
65
68
  ```
66
69
 
67
- 只有确认没有对应 active change 时才运行 `new`。配置缺失时,它会创建默认 Native 配置与 `docs/comet/`;随后创建一个 Shape change、把它设为当前 selection,并返回 continuation。
70
+ 只有扫描当前仓库已登记工作目录并确认没有对应 active change 时才运行 `new`。配置缺失时,它会创建默认 Native 配置与 `docs/comet/`;随后创建一个 Shape change、把它设为当前 change,并返回 continuation 和 workspace 绑定。
71
+
72
+ `--isolation` 缺省为 `current`。`branch` 和 `worktree` 要求 Agent 先创建/切换实际分支或 worktree,并明确传入创建时所在的 `--target-branch`;Runtime 会核对 `--change-branch` 与当前分支。`worktree` 只能在 linked Git worktree 中创建。新 change 的 workspace 绑定会记录工作方式、change 分支、目标分支和物理工作目录身份,后续写入必须保持一致。
73
+
74
+ 退出码 `73` 且 `error.code: workspace-isolation-required` 表示同一个工作目录已在本次 mutation lock 中发现其他 active change。只有原方式是系统默认 `current` 时才自动改用新 worktree;若用户明确选择的方式失效,重新确认。
68
75
 
69
76
  创建后立即运行 `show <change-name>` 与 `status <change-name>`,然后进入 Shape 澄清与共享理解确认。不要创建新 change 来绕过旧 change 的阻塞、冲突或恢复问题。
70
77
 
@@ -98,6 +105,8 @@ checkpoint 只保存恢复摘要和真实产物引用,不改变 phase,也不
98
105
 
99
106
  `evidence format` 从 stdin 或 `--entries` 读取验收条目,输出可原样粘贴到 `verification.md` 的规范机器块。
100
107
 
108
+ 提交 `pass` 时,Runtime 会先校验报告格式、完整验收矩阵和 acceptance receipt;只有校验通过后才执行或复用当前 scope 的内置 required check。报告校验失败时先按错误信息修正 `verification.md`,不要重复提交同一个 `next`。`next` 不接受 `--receipt`,也不需要调用方传入 required-check receipt。
109
+
101
110
  ## Acceptance receipt
102
111
 
103
112
  自动验证:
@@ -113,7 +122,7 @@ comet native receipt automated <change-name> \
113
122
 
114
123
  ```text
115
124
  comet native receipt manual <change-name> \
116
- --acceptance <id> \
125
+ --acceptance <id>... \
117
126
  --step <text> \
118
127
  --observation <text>
119
128
  ```
@@ -144,16 +153,16 @@ comet native next <change-name> --summary <text> \
144
153
  [--report <change-relative-path>] \
145
154
  [--override-repair <sha256> --override-summary <text>]
146
155
 
147
- comet native archive <change-name> --dry-run
156
+ comet native archive <change-name> --dry-run [--finish merge|push|pull-request|keep]
148
157
  comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
149
158
  ```
150
159
 
151
160
  - Shape:只有用户确认最终共享理解后才传 `--confirmed`。
152
161
  - Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。如果需求变化引入新的用户决定,先保持在 Build 并重新完成澄清与确认;确认后更新正式产物,再执行 Runtime 返回的 transition 命令并传入 `--confirmed`。
153
162
  - Partial scope:先向用户说明 Runtime 返回的具体缺口和风险。超出已返回明细预算的变化由 `scope-detail-overflow` 数量和内容 hash 汇总;只有用户接受后才使用完全匹配的 scope hash、理由和 `--confirmed`。
154
- - Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md`。Runtime 在 pass 时自动执行内置 required check;报告中的 acceptance 条目直接引用 automated/manual receipt。已执行但失败的条目引用对应失败 receipt,未执行的条目写明 `skipped_reason`。repair 的失败 acceptance 和检查标识由 Runtime 从报告与 receipt 自动推导。
163
+ - Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md`。Runtime 先校验报告格式、完整验收矩阵和 acceptance receipt,再在 pass 时执行或复用当前 scope 的内置 required check;不要传入 `--receipt`。报告中的 acceptance 条目直接引用 automated/manual receipt。已执行但失败的条目引用对应失败 receipt,未执行的条目写明 `skipped_reason`。repair 的失败 acceptance 和检查标识由 Runtime 从报告与 receipt 自动推导。
155
164
  - Repair override:只使用 status 返回的 signature,并且只在有一个明确新修复假设时执行。
156
- - Archive:先 dry-run,再使用本次预演返回的精确 preflight hash;`required` 模式还需要用户明确确认。
165
+ - Archive:current 直接 dry-run;branch/worktree 在用户完成联合收尾选择后,用 `--finish` 把选择持久化并生成新的 preflight。后续使用本次预演返回的精确 preflight hash;`required` 模式还需要用户明确确认。不得把 `--finish` 与 `--expect-preflight` 同时传入。
157
166
 
158
167
  ## 诊断与恢复
159
168
 
@@ -14,7 +14,18 @@ comet native doctor [<change-name>]
14
14
 
15
15
  ## 工作区提示
16
16
 
17
- `workspace-root-changed` 与 `workspace-inspection-unavailable` 只用于解释当前 root 事实的来源,不单独阻止推进或 Archive。不要把任意 `workspace-*` finding 都当作提示:未知的 workspace 完整性 finding 仍是错误。Runtime 要求修复工作区身份时,先运行只读 doctor,再按报告执行显式 `doctor --repair`。
17
+ 先用 `git worktree list --porcelain` 和每个安全可访问目录中的 `comet native status --project-root <path> --json` 查找 change 的实际工作目录。不要复制 active change 目录、不要在另一个 worktree 重建同名 change,也不要通过改 `workspace.json` 接管。
18
+
19
+ 旧元数据的 `workspace-root-changed` 与 `workspace-inspection-unavailable` 只用于解释当前 root 事实的来源,不单独阻止推进或 Archive。新绑定的以下错误会阻止写入:
20
+
21
+ - `workspace-binding-root-changed`:当前物理工作目录不是创建 change 的目录;
22
+ - `workspace-branch-changed`:当前分支不是绑定的 change 分支;
23
+ - `workspace-kind-changed`:绑定为 worktree,但当前目录不再是 linked worktree;
24
+ - `workspace-vcs-unavailable`:绑定所需的 Git 工作目录不可用。
25
+
26
+ 找到登记中的原工作目录后,在其中恢复并重新 `select`。原目录或分支确实丢失时保留 artifacts,先运行只读 doctor;Runtime 没有证明可修复时停止并让用户决定恢复目录、从可信备份重建,或放弃 change。不要把任意 `workspace-*` finding 都当作提示,也不要自动刷新 baseline。
27
+
28
+ `workspace-isolation-required` 发生在新建竞态:系统默认 `current` 可自动准备独立 worktree 后重试;显式用户选择失效时重新确认。
18
29
 
19
30
  ## 未完成的阶段推进
20
31
 
@@ -98,9 +109,9 @@ comet native doctor <change-name> --repair --strategy rollback
98
109
 
99
110
  如果旧 root 与新 root 不一致,不删除任何一棵目录;把 doctor 返回的两条路径交给用户处理。
100
111
 
101
- ## 锁、selection 或损坏产物
112
+ ## 锁、当前 change 或损坏产物
102
113
 
103
114
  - 不手动删除锁。只在 doctor 明确判断可安全接管时使用 `--repair`。
104
- - doctor 可以清理指向不存在 change 的 selection。
115
+ - doctor 可以清理指向不存在 change 的当前 change 记录。
105
116
  - 损坏的 config、change 状态、brief、规格或 verification 不会被自动猜测重写。
106
117
  - doctor 无法确定 owner、事务或文件身份时,保留现场并停止。
@@ -44,6 +44,7 @@ export function resolveFastRuntime(argv) {
44
44
  if (classicAsset) return { assetPath: classicAsset, args: argv.slice(1) };
45
45
 
46
46
  if (group === 'workflow' && command === 'resolve') {
47
+ if (tail.includes('--activate')) return null;
47
48
  return {
48
49
  assetPath: 'assets/skills/comet/scripts/comet-entry-runtime.mjs',
49
50
  args: tail,
@@ -49,6 +49,7 @@ const workflow = program.command('workflow').description('Resolve the configured
49
49
  workflow
50
50
  .command('resolve [path]')
51
51
  .description('Resolve /comet to its permanent Native or Classic entry')
52
+ .option('--activate', 'Create project configuration from global defaults when missing')
52
53
  .option('--json', 'Output as JSON')
53
54
  .action(async (targetPath = '.', options) => {
54
55
  const { workflowResolveCommand } = await import('../commands/workflow.js');