@rpamis/comet 0.4.0-beta.11 → 0.4.0-beta.13

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 (514) hide show
  1. package/README.md +1 -1
  2. package/assets/manifest.json +15 -1
  3. package/assets/skills/comet/SKILL.md +10 -12
  4. package/assets/skills/comet/reference/classic-layout.md +2 -2
  5. package/assets/skills/comet/reference/comet-yaml-fields.md +1 -1
  6. package/assets/skills/comet/reference/context-recovery.md +3 -3
  7. package/assets/skills/comet/reference/decision-point.md +4 -5
  8. package/assets/skills/comet/reference/scripts.md +17 -47
  9. package/assets/skills/comet/reference/subagent-dispatch.md +8 -8
  10. package/assets/skills/comet/rules/comet-phase-guard.en.md +2 -2
  11. package/assets/skills/comet/rules/comet-phase-guard.md +2 -2
  12. package/assets/skills/comet/rules/comet-workflow-guard.en.md +4 -3
  13. package/assets/skills/comet/rules/comet-workflow-guard.md +4 -3
  14. package/assets/skills/comet/scripts/comet-archive.mjs +165 -2
  15. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +146 -8071
  16. package/assets/skills/comet/scripts/comet-guard.mjs +207 -2
  17. package/assets/skills/comet/scripts/comet-handoff.mjs +165 -2
  18. package/assets/skills/comet/scripts/comet-hook-guard.mjs +151 -2
  19. package/assets/skills/comet/scripts/comet-hook-router.mjs +155 -12083
  20. package/assets/skills/comet/scripts/comet-intent.mjs +10 -2
  21. package/assets/skills/comet/scripts/comet-resume-probe.mjs +148 -2
  22. package/assets/skills/comet/scripts/comet-runtime.mjs +286 -19192
  23. package/assets/skills/comet/scripts/comet-state.mjs +164 -2
  24. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +149 -2
  25. package/assets/skills/comet-archive/SKILL.md +1 -1
  26. package/assets/skills/comet-build/SKILL.md +13 -14
  27. package/assets/skills/comet-classic/SKILL.md +9 -9
  28. package/assets/skills/comet-design/SKILL.md +4 -4
  29. package/assets/skills/comet-hotfix/SKILL.md +2 -2
  30. package/assets/skills/comet-native/SKILL.md +35 -22
  31. package/assets/skills/comet-native/reference/artifacts.md +0 -7
  32. package/assets/skills/comet-native/reference/clarification.md +1 -1
  33. package/assets/skills/comet-native/reference/commands.md +69 -57
  34. package/assets/skills/comet-native/reference/recovery.md +11 -1
  35. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +178 -0
  36. package/assets/skills/comet-native/scripts/comet-native-check.mjs +173 -0
  37. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +179 -0
  38. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +207 -0
  39. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +151 -0
  40. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +150 -2
  41. package/assets/skills/comet-native/scripts/comet-native-init.mjs +171 -0
  42. package/assets/skills/comet-native/scripts/comet-native-new.mjs +200 -0
  43. package/assets/skills/comet-native/scripts/comet-native-next.mjs +182 -0
  44. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +179 -0
  45. package/assets/skills/comet-native/scripts/comet-native-root.mjs +185 -0
  46. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +229 -34143
  47. package/assets/skills/comet-native/scripts/comet-native-select.mjs +178 -0
  48. package/assets/skills/comet-native/scripts/comet-native-show.mjs +151 -0
  49. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +181 -0
  50. package/assets/skills/comet-native/scripts/comet-native-status.mjs +175 -0
  51. package/assets/skills/comet-tweak/SKILL.md +2 -2
  52. package/assets/skills/comet-verify/SKILL.md +3 -3
  53. package/assets/skills-zh/comet/SKILL.md +10 -12
  54. package/assets/skills-zh/comet/reference/classic-layout.md +2 -2
  55. package/assets/skills-zh/comet/reference/comet-yaml-fields.md +1 -1
  56. package/assets/skills-zh/comet/reference/context-recovery.md +3 -3
  57. package/assets/skills-zh/comet/reference/decision-point.md +4 -5
  58. package/assets/skills-zh/comet/reference/scripts.md +9 -39
  59. package/assets/skills-zh/comet/reference/subagent-dispatch.md +8 -8
  60. package/assets/skills-zh/comet-archive/SKILL.md +1 -1
  61. package/assets/skills-zh/comet-build/SKILL.md +13 -14
  62. package/assets/skills-zh/comet-classic/SKILL.md +7 -7
  63. package/assets/skills-zh/comet-design/SKILL.md +5 -5
  64. package/assets/skills-zh/comet-hotfix/SKILL.md +2 -2
  65. package/assets/skills-zh/comet-native/SKILL.md +35 -22
  66. package/assets/skills-zh/comet-native/reference/artifacts.md +0 -7
  67. package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
  68. package/assets/skills-zh/comet-native/reference/commands.md +69 -57
  69. package/assets/skills-zh/comet-native/reference/recovery.md +11 -1
  70. package/assets/skills-zh/comet-tweak/SKILL.md +2 -2
  71. package/assets/skills-zh/comet-verify/SKILL.md +3 -3
  72. package/bin/comet.js +5 -1
  73. package/bin/fast-runtime-router.js +82 -0
  74. package/dist/app/cli/index.js +57 -18
  75. package/dist/app/cli/index.js.map +1 -1
  76. package/dist/app/commands/classic.js +2 -2
  77. package/dist/app/commands/classic.js.map +1 -1
  78. package/dist/app/commands/dashboard.d.ts.map +1 -1
  79. package/dist/app/commands/dashboard.js +2 -1
  80. package/dist/app/commands/dashboard.js.map +1 -1
  81. package/dist/app/commands/doctor.d.ts.map +1 -1
  82. package/dist/app/commands/doctor.js +9 -3
  83. package/dist/app/commands/doctor.js.map +1 -1
  84. package/dist/app/commands/i18n.d.ts +1 -1
  85. package/dist/app/commands/i18n.d.ts.map +1 -1
  86. package/dist/app/commands/i18n.js +10 -0
  87. package/dist/app/commands/i18n.js.map +1 -1
  88. package/dist/app/commands/init.d.ts.map +1 -1
  89. package/dist/app/commands/init.js +9 -5
  90. package/dist/app/commands/init.js.map +1 -1
  91. package/dist/app/commands/uninstall.d.ts.map +1 -1
  92. package/dist/app/commands/uninstall.js +150 -8
  93. package/dist/app/commands/uninstall.js.map +1 -1
  94. package/dist/app/commands/update.d.ts +1 -0
  95. package/dist/app/commands/update.d.ts.map +1 -1
  96. package/dist/app/commands/update.js +166 -24
  97. package/dist/app/commands/update.js.map +1 -1
  98. package/dist/config/repository-layout.json +33 -6
  99. package/dist/domains/comet-classic/classic-archive-entry.js +1 -1
  100. package/dist/domains/comet-classic/classic-archive-entry.js.map +1 -1
  101. package/dist/domains/comet-classic/classic-branch-binding.d.ts.map +1 -1
  102. package/dist/domains/comet-classic/classic-branch-binding.js +8 -2
  103. package/dist/domains/comet-classic/classic-branch-binding.js.map +1 -1
  104. package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
  105. package/dist/domains/comet-classic/classic-current-change.js +6 -1
  106. package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
  107. package/dist/domains/comet-classic/classic-guard-entry.js +1 -1
  108. package/dist/domains/comet-classic/classic-guard-entry.js.map +1 -1
  109. package/dist/domains/comet-classic/classic-guard.js +1 -1
  110. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  111. package/dist/domains/comet-classic/classic-handoff-entry.js +1 -1
  112. package/dist/domains/comet-classic/classic-handoff-entry.js.map +1 -1
  113. package/dist/domains/comet-classic/classic-hook-guard-entry.js +1 -1
  114. package/dist/domains/comet-classic/classic-hook-guard-entry.js.map +1 -1
  115. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  116. package/dist/domains/comet-classic/classic-hook-guard.js +7 -4
  117. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  118. package/dist/domains/comet-classic/classic-intent-entry.js +1 -1
  119. package/dist/domains/comet-classic/classic-intent-entry.js.map +1 -1
  120. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
  121. package/dist/domains/comet-classic/classic-layout-initialization.js +18 -11
  122. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  123. package/dist/domains/comet-classic/classic-layout.d.ts +7 -4
  124. package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
  125. package/dist/domains/comet-classic/classic-layout.js +9 -9
  126. package/dist/domains/comet-classic/classic-layout.js.map +1 -1
  127. package/dist/domains/comet-classic/classic-resume-probe-entry.js +1 -1
  128. package/dist/domains/comet-classic/classic-resume-probe-entry.js.map +1 -1
  129. package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
  130. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  131. package/dist/domains/comet-classic/classic-root-command.js +159 -49
  132. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  133. package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
  134. package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
  135. package/dist/domains/comet-classic/classic-root-move.js +24 -121
  136. package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
  137. package/dist/domains/comet-classic/classic-script-entry.d.ts +2 -2
  138. package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
  139. package/dist/domains/comet-classic/classic-script-entry.js +4 -3
  140. package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
  141. package/dist/domains/comet-classic/classic-state-command.js +6 -6
  142. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  143. package/dist/domains/comet-classic/classic-state-entry.js +1 -1
  144. package/dist/domains/comet-classic/classic-state-entry.js.map +1 -1
  145. package/dist/domains/comet-classic/classic-validate-entry.js +1 -1
  146. package/dist/domains/comet-classic/classic-validate-entry.js.map +1 -1
  147. package/dist/domains/comet-entry/current-selection-repair.js +1 -1
  148. package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
  149. package/dist/domains/comet-entry/entry-reads.d.ts +17 -0
  150. package/dist/domains/comet-entry/entry-reads.d.ts.map +1 -0
  151. package/dist/domains/comet-entry/entry-reads.js +20 -0
  152. package/dist/domains/comet-entry/entry-reads.js.map +1 -0
  153. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  154. package/dist/domains/comet-entry/hook-router-entry.js +3 -1
  155. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  156. package/dist/domains/comet-entry/hook-router.d.ts +12 -2
  157. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  158. package/dist/domains/comet-entry/hook-router.js +48 -17
  159. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  160. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  161. package/dist/domains/comet-entry/init-workflow.js +7 -8
  162. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  163. package/dist/domains/comet-entry/resolve-entry.d.ts.map +1 -1
  164. package/dist/domains/comet-entry/resolve-entry.js +3 -4
  165. package/dist/domains/comet-entry/resolve-entry.js.map +1 -1
  166. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  167. package/dist/domains/comet-entry/resume-probe.js +16 -5
  168. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  169. package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
  170. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  171. package/dist/domains/comet-native/native-acceptance.js +5 -29
  172. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  173. package/dist/domains/comet-native/native-archive-command.d.ts +3 -0
  174. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -0
  175. package/dist/domains/comet-native/native-archive-command.js +49 -0
  176. package/dist/domains/comet-native/native-archive-command.js.map +1 -0
  177. package/dist/domains/comet-native/native-archive-entry.d.ts +2 -0
  178. package/dist/domains/comet-native/native-archive-entry.d.ts.map +1 -0
  179. package/dist/domains/comet-native/native-archive-entry.js +4 -0
  180. package/dist/domains/comet-native/native-archive-entry.js.map +1 -0
  181. package/dist/domains/comet-native/native-check-command.d.ts +3 -0
  182. package/dist/domains/comet-native/native-check-command.d.ts.map +1 -0
  183. package/dist/domains/comet-native/native-check-command.js +30 -0
  184. package/dist/domains/comet-native/native-check-command.js.map +1 -0
  185. package/dist/domains/comet-native/native-check-entry.d.ts +2 -0
  186. package/dist/domains/comet-native/native-check-entry.d.ts.map +1 -0
  187. package/dist/domains/comet-native/native-check-entry.js +4 -0
  188. package/dist/domains/comet-native/native-check-entry.js.map +1 -0
  189. package/dist/domains/comet-native/native-checkpoint-command.d.ts +3 -0
  190. package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -0
  191. package/dist/domains/comet-native/native-checkpoint-command.js +39 -0
  192. package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -0
  193. package/dist/domains/comet-native/native-checkpoint-entry.d.ts +2 -0
  194. package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +1 -0
  195. package/dist/domains/comet-native/native-checkpoint-entry.js +4 -0
  196. package/dist/domains/comet-native/native-checkpoint-entry.js.map +1 -0
  197. package/dist/domains/comet-native/native-cli-shared.d.ts +40 -0
  198. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -0
  199. package/dist/domains/comet-native/native-cli-shared.js +272 -0
  200. package/dist/domains/comet-native/native-cli-shared.js.map +1 -0
  201. package/dist/domains/comet-native/native-cli.d.ts +2 -5
  202. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  203. package/dist/domains/comet-native/native-cli.js +37 -1228
  204. package/dist/domains/comet-native/native-cli.js.map +1 -1
  205. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  206. package/dist/domains/comet-native/native-continuation.js +34 -5
  207. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  208. package/dist/domains/comet-native/native-doctor-command.d.ts +3 -0
  209. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -0
  210. package/dist/domains/comet-native/native-doctor-command.js +29 -0
  211. package/dist/domains/comet-native/native-doctor-command.js.map +1 -0
  212. package/dist/domains/comet-native/native-doctor-entry.d.ts +2 -0
  213. package/dist/domains/comet-native/native-doctor-entry.d.ts.map +1 -0
  214. package/dist/domains/comet-native/native-doctor-entry.js +4 -0
  215. package/dist/domains/comet-native/native-doctor-entry.js.map +1 -0
  216. package/dist/domains/comet-native/native-evidence-command.d.ts +3 -0
  217. package/dist/domains/comet-native/native-evidence-command.d.ts.map +1 -0
  218. package/dist/domains/comet-native/native-evidence-command.js +35 -0
  219. package/dist/domains/comet-native/native-evidence-command.js.map +1 -0
  220. package/dist/domains/comet-native/native-evidence-entry.d.ts +2 -0
  221. package/dist/domains/comet-native/native-evidence-entry.d.ts.map +1 -0
  222. package/dist/domains/comet-native/native-evidence-entry.js +4 -0
  223. package/dist/domains/comet-native/native-evidence-entry.js.map +1 -0
  224. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  225. package/dist/domains/comet-native/native-evidence-retention.js +5 -21
  226. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  227. package/dist/domains/comet-native/native-evidence-storage.d.ts +19 -14
  228. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  229. package/dist/domains/comet-native/native-evidence-storage.js +91 -46
  230. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  231. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  232. package/dist/domains/comet-native/native-findings.js +24 -4
  233. package/dist/domains/comet-native/native-findings.js.map +1 -1
  234. package/dist/domains/comet-native/native-hook-guard-command.d.ts +3 -0
  235. package/dist/domains/comet-native/native-hook-guard-command.d.ts.map +1 -0
  236. package/dist/domains/comet-native/native-hook-guard-command.js +32 -0
  237. package/dist/domains/comet-native/native-hook-guard-command.js.map +1 -0
  238. package/dist/domains/comet-native/native-hook-guard-entry.d.ts +2 -0
  239. package/dist/domains/comet-native/native-hook-guard-entry.d.ts.map +1 -0
  240. package/dist/domains/comet-native/native-hook-guard-entry.js +4 -0
  241. package/dist/domains/comet-native/native-hook-guard-entry.js.map +1 -0
  242. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  243. package/dist/domains/comet-native/native-hook-guard.js +7 -1
  244. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  245. package/dist/domains/comet-native/native-init-command.d.ts +3 -0
  246. package/dist/domains/comet-native/native-init-command.d.ts.map +1 -0
  247. package/dist/domains/comet-native/native-init-command.js +29 -0
  248. package/dist/domains/comet-native/native-init-command.js.map +1 -0
  249. package/dist/domains/comet-native/native-init-entry.d.ts +2 -0
  250. package/dist/domains/comet-native/native-init-entry.d.ts.map +1 -0
  251. package/dist/domains/comet-native/native-init-entry.js +4 -0
  252. package/dist/domains/comet-native/native-init-entry.js.map +1 -0
  253. package/dist/domains/comet-native/native-new-command.d.ts +3 -0
  254. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -0
  255. package/dist/domains/comet-native/native-new-command.js +35 -0
  256. package/dist/domains/comet-native/native-new-command.js.map +1 -0
  257. package/dist/domains/comet-native/native-new-entry.d.ts +2 -0
  258. package/dist/domains/comet-native/native-new-entry.d.ts.map +1 -0
  259. package/dist/domains/comet-native/native-new-entry.js +4 -0
  260. package/dist/domains/comet-native/native-new-entry.js.map +1 -0
  261. package/dist/domains/comet-native/native-next-command.d.ts +3 -0
  262. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -0
  263. package/dist/domains/comet-native/native-next-command.js +82 -0
  264. package/dist/domains/comet-native/native-next-command.js.map +1 -0
  265. package/dist/domains/comet-native/native-next-entry.d.ts +2 -0
  266. package/dist/domains/comet-native/native-next-entry.d.ts.map +1 -0
  267. package/dist/domains/comet-native/native-next-entry.js +4 -0
  268. package/dist/domains/comet-native/native-next-entry.js.map +1 -0
  269. package/dist/domains/comet-native/native-receipt-command.d.ts +3 -0
  270. package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -0
  271. package/dist/domains/comet-native/native-receipt-command.js +107 -0
  272. package/dist/domains/comet-native/native-receipt-command.js.map +1 -0
  273. package/dist/domains/comet-native/native-receipt-entry.d.ts +2 -0
  274. package/dist/domains/comet-native/native-receipt-entry.d.ts.map +1 -0
  275. package/dist/domains/comet-native/native-receipt-entry.js +4 -0
  276. package/dist/domains/comet-native/native-receipt-entry.js.map +1 -0
  277. package/dist/domains/comet-native/native-receipt-refresh.d.ts +86 -0
  278. package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -0
  279. package/dist/domains/comet-native/native-receipt-refresh.js +232 -0
  280. package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -0
  281. package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
  282. package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
  283. package/dist/domains/comet-native/native-repair-integration.js +12 -15
  284. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  285. package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
  286. package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
  287. package/dist/domains/comet-native/native-repair-runtime.js +3 -10
  288. package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
  289. package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
  290. package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
  291. package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
  292. package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
  293. package/dist/domains/comet-native/native-root-command.d.ts +3 -0
  294. package/dist/domains/comet-native/native-root-command.d.ts.map +1 -0
  295. package/dist/domains/comet-native/native-root-command.js +29 -0
  296. package/dist/domains/comet-native/native-root-command.js.map +1 -0
  297. package/dist/domains/comet-native/native-root-entry.d.ts +2 -0
  298. package/dist/domains/comet-native/native-root-entry.d.ts.map +1 -0
  299. package/dist/domains/comet-native/native-root-entry.js +4 -0
  300. package/dist/domains/comet-native/native-root-entry.js.map +1 -0
  301. package/dist/domains/comet-native/native-script-entry.d.ts +12 -0
  302. package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -0
  303. package/dist/domains/comet-native/native-script-entry.js +44 -0
  304. package/dist/domains/comet-native/native-script-entry.js.map +1 -0
  305. package/dist/domains/comet-native/native-select-command.d.ts +3 -0
  306. package/dist/domains/comet-native/native-select-command.d.ts.map +1 -0
  307. package/dist/domains/comet-native/native-select-command.js +15 -0
  308. package/dist/domains/comet-native/native-select-command.js.map +1 -0
  309. package/dist/domains/comet-native/native-select-entry.d.ts +2 -0
  310. package/dist/domains/comet-native/native-select-entry.d.ts.map +1 -0
  311. package/dist/domains/comet-native/native-select-entry.js +4 -0
  312. package/dist/domains/comet-native/native-select-entry.js.map +1 -0
  313. package/dist/domains/comet-native/native-show-command.d.ts +3 -0
  314. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -0
  315. package/dist/domains/comet-native/native-show-command.js +41 -0
  316. package/dist/domains/comet-native/native-show-command.js.map +1 -0
  317. package/dist/domains/comet-native/native-show-entry.d.ts +2 -0
  318. package/dist/domains/comet-native/native-show-entry.d.ts.map +1 -0
  319. package/dist/domains/comet-native/native-show-entry.js +4 -0
  320. package/dist/domains/comet-native/native-show-entry.js.map +1 -0
  321. package/dist/domains/comet-native/native-snapshot.d.ts +9 -0
  322. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  323. package/dist/domains/comet-native/native-snapshot.js +141 -45
  324. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  325. package/dist/domains/comet-native/native-spec-command.d.ts +3 -0
  326. package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -0
  327. package/dist/domains/comet-native/native-spec-command.js +34 -0
  328. package/dist/domains/comet-native/native-spec-command.js.map +1 -0
  329. package/dist/domains/comet-native/native-spec-entry.d.ts +2 -0
  330. package/dist/domains/comet-native/native-spec-entry.d.ts.map +1 -0
  331. package/dist/domains/comet-native/native-spec-entry.js +4 -0
  332. package/dist/domains/comet-native/native-spec-entry.js.map +1 -0
  333. package/dist/domains/comet-native/native-status-command.d.ts +3 -0
  334. package/dist/domains/comet-native/native-status-command.d.ts.map +1 -0
  335. package/dist/domains/comet-native/native-status-command.js +36 -0
  336. package/dist/domains/comet-native/native-status-command.js.map +1 -0
  337. package/dist/domains/comet-native/native-status-entry.d.ts +2 -0
  338. package/dist/domains/comet-native/native-status-entry.d.ts.map +1 -0
  339. package/dist/domains/comet-native/native-status-entry.js +4 -0
  340. package/dist/domains/comet-native/native-status-entry.js.map +1 -0
  341. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  342. package/dist/domains/comet-native/native-transition-evidence.js +0 -10
  343. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  344. package/dist/domains/comet-native/native-transitions.d.ts +4 -0
  345. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  346. package/dist/domains/comet-native/native-transitions.js +31 -35
  347. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  348. package/dist/domains/comet-native/native-types.d.ts +8 -6
  349. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  350. package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
  351. package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
  352. package/dist/domains/comet-native/native-verification-evidence.js +13 -301
  353. package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
  354. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +16 -138
  355. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  356. package/dist/domains/comet-native/native-verification-receipt-runtime.js +132 -770
  357. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  358. package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
  359. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
  360. package/dist/domains/comet-native/native-verification-receipt.js +19 -350
  361. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
  362. package/dist/domains/comet-native/native-verification-runtime.d.ts +28 -4
  363. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  364. package/dist/domains/comet-native/native-verification-runtime.js +101 -218
  365. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  366. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  367. package/dist/domains/dashboard/collector.js +53 -41
  368. package/dist/domains/dashboard/collector.js.map +1 -1
  369. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  370. package/dist/domains/dashboard/native-collector.js +13 -3
  371. package/dist/domains/dashboard/native-collector.js.map +1 -1
  372. package/dist/domains/dashboard/project-directory.d.ts +20 -0
  373. package/dist/domains/dashboard/project-directory.d.ts.map +1 -0
  374. package/dist/domains/dashboard/project-directory.js +87 -0
  375. package/dist/domains/dashboard/project-directory.js.map +1 -0
  376. package/dist/domains/dashboard/project-root.d.ts +8 -0
  377. package/dist/domains/dashboard/project-root.d.ts.map +1 -0
  378. package/dist/domains/dashboard/project-root.js +68 -0
  379. package/dist/domains/dashboard/project-root.js.map +1 -0
  380. package/dist/domains/dashboard/server.d.ts +1 -0
  381. package/dist/domains/dashboard/server.d.ts.map +1 -1
  382. package/dist/domains/dashboard/server.js +50 -10
  383. package/dist/domains/dashboard/server.js.map +1 -1
  384. package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-mNt_SS1l.js} +1 -1
  385. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-Bc5akVD6.js +36 -0
  386. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-C43zhVBe.js} +2 -2
  387. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-dToETarK.js} +2 -2
  388. package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +1 -0
  389. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-C0oO137R.js} +1 -1
  390. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CGms1fgI.js} +1 -1
  391. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-Bugl8v6f.js} +1 -1
  392. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-8ATNMlBG.js} +1 -1
  393. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-BNYjSSqU.js} +1 -1
  394. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-_nJAqSbe.js} +1 -1
  395. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-lyxYm5NX.js} +1 -1
  396. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-PUMVeWpd.js} +1 -1
  397. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +1 -0
  398. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +1 -0
  399. package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-DzMqjexn.js +1 -0
  400. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-B67ET0eq.js} +1 -1
  401. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-CQPMvRLK.js +4 -0
  402. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-BRpLrFHM.js +43 -0
  403. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-CPGWuGrE.js +10 -0
  404. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-D2wpX2iO.js} +2 -2
  405. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-D54mAbDu.js +24 -0
  406. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-ZGQDpSs_.js +24 -0
  407. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-C3qDo7sd.js} +2 -2
  408. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-B7hStPd9.js} +2 -2
  409. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-IqcLFbTK.js +292 -0
  410. package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-YrMZpzUu.js +106 -0
  411. package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +257 -0
  412. package/dist/domains/dashboard/web/assets/{index-QO0z6F4w.js → index-icxk8_BP.js} +1 -1
  413. package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +1 -0
  414. package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-CcIgGK_7.js +2 -0
  415. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-1x3rNjGP.js} +2 -2
  416. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-B2XiqMNP.js} +2 -2
  417. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-x46cGuo3.js} +2 -2
  418. package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-DFLqGZWl.js} +1 -1
  419. package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-g3J6BACc.js} +69 -69
  420. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-CTdeKmcX.js} +2 -2
  421. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-C_obwjIf.js} +2 -2
  422. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-B6Gnfz9M.js} +4 -4
  423. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-nX4PObnB.js} +2 -2
  424. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-QjDwwHgl.js} +2 -2
  425. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK-BEEe0j6B.js} +2 -2
  426. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CXfAaBgM.js +1 -0
  427. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +1 -0
  428. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-BOzX2EnD.js} +2 -2
  429. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-C40vhXRq.js} +2 -2
  430. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-B1rm89JH.js} +2 -2
  431. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-BlMr59qK.js} +2 -2
  432. package/dist/domains/dashboard/web/index.html +2 -2
  433. package/dist/domains/integrations/openspec.d.ts +1 -0
  434. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  435. package/dist/domains/integrations/openspec.js +6 -0
  436. package/dist/domains/integrations/openspec.js.map +1 -1
  437. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  438. package/dist/domains/skill/platform-install.js +4 -6
  439. package/dist/domains/skill/platform-install.js.map +1 -1
  440. package/dist/domains/skill/uninstall.d.ts +6 -2
  441. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  442. package/dist/domains/skill/uninstall.js +128 -19
  443. package/dist/domains/skill/uninstall.js.map +1 -1
  444. package/dist/domains/workflow-contract/project-config.d.ts +1 -0
  445. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  446. package/dist/domains/workflow-contract/project-config.js +45 -1
  447. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  448. package/dist/platform/install/detect.d.ts +1 -0
  449. package/dist/platform/install/detect.d.ts.map +1 -1
  450. package/dist/platform/install/detect.js +2 -0
  451. package/dist/platform/install/detect.js.map +1 -1
  452. package/dist/platform/process/hook-read-cache.d.ts +45 -0
  453. package/dist/platform/process/hook-read-cache.d.ts.map +1 -0
  454. package/dist/platform/process/hook-read-cache.js +102 -0
  455. package/dist/platform/process/hook-read-cache.js.map +1 -0
  456. package/dist/platform/version/version.d.ts.map +1 -1
  457. package/dist/platform/version/version.js +9 -2
  458. package/dist/platform/version/version.js.map +1 -1
  459. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +2 -0
  460. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -0
  461. package/eval/local/tasks/comet-native-workflow/instruction.md +5 -17
  462. package/eval/local/tasks/comet-native-workflow/task.toml +4 -2
  463. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +227 -300
  464. package/eval/local/tests/conftest.py +0 -193
  465. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +107 -180
  466. package/eval/local/tests/scaffold/test_tasks.py +6 -9
  467. package/eval/local/tests/scaffold/test_utils.py +4 -7
  468. package/eval/scaffold/shell/docker.sh +2 -95
  469. package/package.json +7 -3
  470. package/dist/domains/comet-native/native-controller-trust.d.ts +0 -21
  471. package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
  472. package/dist/domains/comet-native/native-controller-trust.js +0 -140
  473. package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
  474. package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
  475. package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
  476. package/dist/domains/comet-native/native-independent-review.js +0 -134
  477. package/dist/domains/comet-native/native-independent-review.js.map +0 -1
  478. package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
  479. package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
  480. package/dist/domains/comet-native/native-review-contract.js +0 -6
  481. package/dist/domains/comet-native/native-review-contract.js.map +0 -1
  482. package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
  483. package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
  484. package/dist/domains/comet-native/native-review-identity.js +0 -209
  485. package/dist/domains/comet-native/native-review-identity.js.map +0 -1
  486. package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
  487. package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
  488. package/dist/domains/comet-native/native-review-signer.js +0 -125
  489. package/dist/domains/comet-native/native-review-signer.js.map +0 -1
  490. package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
  491. package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
  492. package/dist/domains/comet-native/native-review-trust.js +0 -176
  493. package/dist/domains/comet-native/native-review-trust.js.map +0 -1
  494. package/dist/domains/dashboard/web/assets/_commonjsHelpers-CqkleIqs.js +0 -1
  495. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-CjVHPivo.js +0 -36
  496. package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
  497. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
  498. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
  499. package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-CZk37fGn.js +0 -1
  500. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-D5BQ0eqN.js +0 -4
  501. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-33mXstha.js +0 -43
  502. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-BWHCMFvD.js +0 -10
  503. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-BBlsg7jG.js +0 -24
  504. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-CsaFSpHi.js +0 -24
  505. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-D1SQ56fl.js +0 -292
  506. package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-D4oDMS5x.js +0 -106
  507. package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
  508. package/dist/domains/dashboard/web/assets/index-Msce_H_q.js +0 -24
  509. package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-BeICn98s.js +0 -2
  510. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CcFBc6qh.js +0 -1
  511. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
  512. package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
  513. package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
  514. package/eval/scaffold/shell/native-review-verifier-daemon.mjs +0 -178
@@ -29,7 +29,7 @@ Streamlined OpenSpec artifacts must use the configured Comet artifact language.
29
29
 
30
30
  Execution chain: open → OpenSpec apply → verify → archive. Tweak provides default decisions for each phase: streamlined open, direct build through OpenSpec apply, scale- and delta-spec-driven verification weight, and final archive confirmation after verification passes.
31
31
 
32
- Before starting, locate Comet scripts via `comet/reference/scripts.md`. When resuming from any entry point, first use `comet/reference/context-recovery.md` to confirm phase/workflow.
32
+ Before starting, use `comet/reference/scripts.md` to run the public Comet CLI command. When resuming from any entry point, first use `comet/reference/context-recovery.md` to check phase/workflow.
33
33
 
34
34
  When resuming an existing tweak change, the first state operation must be `comet state select <change-name>`. For a new change, run the command immediately after `.comet.yaml` initialization and before source writes.
35
35
 
@@ -156,7 +156,7 @@ Exception: when `.comet.yaml` has `auto_transition: false`, end the current invo
156
156
 
157
157
  The following genuine user decisions still pause:
158
158
 
159
- 1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Must use the current platform's available user input/confirmation mechanism to pause and wait for the user to explicitly choose**: continue the tweak lightweight flow, or upgrade to the full `/comet-classic` workflow
159
+ 1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Pause, present the choices, and wait for the user to explicitly choose**: continue the tweak lightweight flow, or upgrade to the full `/comet-classic` workflow
160
160
  2. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or strategy after the automatic repair limit; the first 3 clearly repairable failures close automatically
161
161
  3. Final archive confirmation and the branch-handling decision after the archive commit
162
162
 
@@ -63,7 +63,7 @@ comet state get <change-name> plan
63
63
  git diff --stat <base-ref read from plan frontmatter>...HEAD
64
64
  ```
65
65
 
66
- The first command returns the plan path. Use the host's file reader to parse the single `base-ref` frontmatter field, validate it as a commit, then substitute it into the second command. Do not depend on POSIX text pipelines.
66
+ The first command returns the plan path. Use the file-reading tool to parse the single `base-ref` frontmatter field, validate it as a commit, then substitute it into the second command. Do not depend on POSIX text pipelines.
67
67
 
68
68
  If commit range shows changes exceed lightweight threshold (> 8 files, cross-module coordination, or delta spec spans more than 1 capability), manually set to full verification:
69
69
 
@@ -173,7 +173,7 @@ comet state transition <change-name> verify-fail
173
173
  ```
174
174
 
175
175
  **Spec Drift Handling** (user decision point):
176
- - If check item 6 finds contradictions (delta spec has content but design doc does not reflect it), **must use the current platform's available user input/confirmation mechanism as a single-select question to pause and wait for the user to choose the handling method**; must not select automatically. Options:
176
+ - If check item 6 finds contradictions (delta spec has content but design doc does not reflect it), **pause, present the handling methods as a single-select question, and wait for the user to choose**; must not select automatically. Options:
177
177
  - Option A: Append "Implementation Divergence" section to design doc recording deviation reason. Option A is a verify phase allowed artifact; after writing, must not re-trigger Step 1b dirty-worktree decision due to that design doc change
178
178
  - Option B: After user selects B, run `comet state transition <change-name> verify-fail`, then invoke `/comet-build`; `/comet-build`'s Spec Incremental Update rules will load the Superpowers `brainstorming` skill to update Design Doc + delta spec
179
179
  - Option C: Confirm deviation is acceptable, continue verification (design doc will be marked as `superseded-by-main-spec` during archiving)
@@ -186,7 +186,7 @@ Save the verification report and record it in `.comet.yaml`. Do not handle, merg
186
186
  comet state set <change-name> verification_report docs/superpowers/reports/YYYY-MM-DD-<change-name>-verify.md
187
187
  ```
188
188
 
189
- Use the host's file API to create `docs/superpowers/reports/` and the report file; do not depend on a POSIX-only directory command.
189
+ Use the file tool to create `docs/superpowers/reports/` and the report file; do not depend on a POSIX-only directory command.
190
190
 
191
191
  ## Exit Conditions
192
192
 
@@ -1,28 +1,26 @@
1
1
  ---
2
2
  name: comet
3
- description: "当用户调用 /comet 或需要恢复 active Comet change 时,按项目配置路由到永久的 Comet Native 或 Comet Classic 入口。"
3
+ description: "当用户明确调用 /comet,或明确要求使用 Comet 但未指定 Native/Classic 时使用;只按项目配置加载一个永久入口。"
4
4
  ---
5
5
 
6
6
  # Comet 入口
7
7
 
8
8
  `/comet` 只负责选择入口,不包含任何一种工作流的执行方法。
9
9
 
10
- 1. 先在当前项目尝试 PATH 中安装的 Comet CLI:
10
+ 一旦加载本 Skill,就视为已经选定 `/comet` 入口。必须立即执行下方入口解析,不得重新判断任务是否适合 Comet,也不得只解释为什么不使用它。
11
+
12
+ 1. 在当前项目运行 PATH 中安装的 Comet CLI:
11
13
 
12
14
  ```text
13
15
  comet workflow resolve . --json
14
16
  ```
15
17
 
16
- 2. **只有**宿主明确报告 `command not found`、`executable not found` 或 `ENOENT`,能够证明 `comet` 不在 PATH 时,才从当前 `SKILL.md` 所在目录定位 `<comet-skill-root>`,运行自带入口 runtime:
17
-
18
- ```text
19
- node <comet-skill-root>/scripts/comet-entry-runtime.mjs . --json
20
- ```
18
+ 若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整。不得搜索 Skill 文件、扫描平台配置目录或直接调用内部 bundle。CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效时,同样停止并原样说明错误,不要回退或猜测。
19
+ 2. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
20
+ 3. 只按返回的 `skill` 选择下列一个入口。必须立即使用 Skill 工具加载且只加载该入口:
21
+ - `/comet-native` → **立即执行:** 使用 Skill 工具加载 `comet-native` 技能。禁止跳过此步骤。
22
+ - `/comet-classic` → **立即执行:** 使用 Skill 工具加载 `comet-classic` 技能。禁止跳过此步骤。
21
23
 
22
- CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效,都不得使用 bundled runtime 重试;停止并原样说明错误,不要回退或猜测。
23
- 3. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
24
- 4. 只按返回的 `skill` 调用一个入口,并把用户原始请求完整交给它:
25
- - `comet-native` → `/comet-native`
26
- - `comet-classic` → `/comet-classic`
24
+ 技能加载后,把用户原始请求完整交给已加载的入口 Skill,作为该入口的用户输入。
27
25
 
28
26
  不根据任务大小、文件数量、活跃 change 或模型判断改选另一套工作流。Native 与 Classic 的 change、状态和产物始终彼此独立。
@@ -30,5 +30,5 @@ comet classic root show
30
30
 
31
31
  - 新 Classic 项目默认使用 `docs/openspec/`。
32
32
  - 缺少 `classic.artifact_layout` 时默认使用 `docs/openspec/`;`comet update` 检测到已有根目录 `openspec/` 产物时会显式补为 `legacy`,不会移动产物。
33
- - 普通 init/update 不移动旧产物。迁移前运行 `comet classic root move docs --dry-run` 并记录输出的 plan ID;只有用户明确授权后才运行 `comet classic root move docs --apply --plan <id>`。
34
- - 首版迁移不接受任何 active 或 unmanaged OpenSpec change。
33
+ - 普通 init/update 不移动旧产物。运行 `comet classic root move docs --dry-run` 只查看现状;用户确认后运行 `comet classic root move docs --apply` 直接迁移。迁移身份与锁内复检由 Runtime 内部管理。
34
+ - 迁移会原样移动完整的旧布局树,包括 active、unmanaged 和尚未完成归档的 change;change 状态本身不阻塞根目录迁移。
@@ -44,7 +44,7 @@ archived: false
44
44
  | `base_ref` | init 时记录的 git commit SHA,用于 scale 评估。无 plan 时作为改动文件数统计基准 |
45
45
  | `build_mode` | 已选择的执行方式,可为空。取值:`subagent-driven-development`(隔离后台 subagent 逐任务实现并审查)、`executing-plans`(主会话按计划顺序执行)、`direct`(主会话直接编码,默认仅 hotfix/tweak 允许,full workflow 需 `direct_override: true`) |
46
46
  | `build_pause` | build 阶段内部暂停点。`null` 表示无暂停,`plan-ready` 表示 plan 已生成,用户选择切换模型后暂停 |
47
- | `subagent_dispatch` | `null` 或 `confirmed`。仅当已确认当前平台存在真实后台 subagent / Task / multi-agent 调度能力时,`build_mode: subagent-driven-development` 才能写入并用于离开 build 阶段 |
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
50
  | `isolation` | `current`、`branch` 或 `worktree`。full 初始化可为 `null`,离开 build 前必须由用户显式选择 `current`、实际创建/选择 `branch`,或实际创建/选择 `worktree`;hotfix/tweak 在入口用户决策点后也可如实使用三种模式,不得在未创建分支时虚构为 `branch` |
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## 任意入口恢复原则
8
8
 
9
- 用户可能直接从 `/comet-open`、`/comet-design`、`/comet-build`、`/comet-verify`、`/comet-archive`、`/comet-hotfix` 或 `/comet-tweak` 回到流程。进入任意子 Skill 时,都先按 `comet/reference/scripts.md` 定位脚本,再用当前子 Skill 对应 phase 运行入口检查或恢复检查。不得依赖对话历史判断阶段。
9
+ 用户可能直接从 `/comet-open`、`/comet-design`、`/comet-build`、`/comet-verify`、`/comet-archive`、`/comet-hotfix` 或 `/comet-tweak` 回到流程。进入任意子 Skill 时,都先按 `comet/reference/scripts.md` 运行公开 CLI 命令,再用当前子 Skill 对应 phase 运行入口检查或恢复检查。不得依赖对话历史判断阶段。
10
10
 
11
11
  ```bash
12
12
  comet state check <change-name> <phase> --recover
@@ -16,10 +16,10 @@ comet state check <change-name> <phase> --recover
16
16
 
17
17
  ## 未显式 `/comet-classic` 的恢复
18
18
 
19
- 如果用户没有提 `/comet-classic`,但本仓库可能有 active Classic change,开始处理需要改动或调查的任务前先运行 Ambient Resume 探针。先按 `comet/reference/scripts.md` 定位脚本并确保 `$COMET_RESUME_PROBE` 可用,然后把当前用户请求从 stdin 传入:
19
+ 如果用户没有提 `/comet-classic`,但本仓库可能有 active Classic change,开始处理需要改动或调查的任务前先运行 Ambient Resume 探针。按 `comet/reference/scripts.md` 运行公开 CLI 命令,然后把当前用户请求从 stdin 传入:
20
20
 
21
21
  ```bash
22
- node "$COMET_RESUME_PROBE" probe --stdin
22
+ comet resume-probe . --stdin --json
23
23
  ```
24
24
 
25
25
  只有返回 `auto_resume` 才自动恢复;`ask_user` 必须短问用户;`out_of_scope` 和 `none` 不进入 workflow。
@@ -13,14 +13,13 @@
13
13
  - **停止条件**:依赖缺失、状态损坏、路径越界或外部命令不可用,导致当前没有合法下一步;报告阻塞原因和恢复条件,不得伪造选项
14
14
  - **手动衔接**:`NEXT: manual` 只是交还控制权,不是新的用户决策点;输出 `HINT` 后结束当前调用,不再询问“是否继续”
15
15
 
16
- 只有第一类使用本协议。相邻且可同时回答的选择必须合并;已经持久化且仍有效的选择不得重复询问。展示选项前先检查平台能力和状态,只展示真实可执行的选项;若某字段只剩一个合法值,说明原因后直接采用,不为它单独创建停顿点。
16
+ 只有第一类使用本协议。相邻且可同时回答的选择必须合并;已经持久化且仍有效的选择不得重复询问。不得因预判后续工具或操作可能失败而预检、推断或筛除选项。展示本工作流支持的全部选择;用户选择后执行对应动作,若失败则停止并报告原错误。若某字段只剩一个工作流合法值,说明原因后直接采用,不为它单独创建停顿点。
17
17
 
18
18
  ## 核心规则
19
19
 
20
20
  - 决策点是阻塞点。到达决策点时必须暂停,等待用户明确选择后才能继续
21
- - 必须使用当前平台可用的用户输入/确认机制获取选择;Claude Code 等平台提供 `AskUserQuestion` 时,优先使用 `AskUserQuestion` 展示单选/多选选项
22
- - 若当前工具列表没有 `AskUserQuestion`,或第一次调用 `AskUserQuestion` 失败,则判定本会话结构化提问不可用;本会话后续决策点不得反复重试 `AskUserQuestion`,直接使用文本选项降级模式
23
- - 若当前平台没有结构化提问工具,则必须在对话中提出明确选项并停止流程,等待用户回复
21
+ - 存在 `AskUserQuestion` 时,使用它展示单选/多选选项;否则在对话中提出明确选项并等待用户回复
22
+ - 若无法使用 `AskUserQuestion`,则判定本会话结构化提问不可用;本会话后续决策点不得反复重试它,直接使用文本选项降级模式
24
23
  - 不得用推荐规则、默认值、历史偏好或“用户应该会同意”的推断代替当前确认
25
24
  - 用户明确选择前,不得写入对应状态字段、执行对应分支操作或自动继续下一阶段
26
25
 
@@ -31,7 +30,7 @@
31
30
  - 单选决策点用 `AskUserQuestion` 的单选问题;多选决策点用多选问题
32
31
  - 选项必须携带简短标签和影响说明;推荐项只能作为说明,不能自动选择
33
32
  - 若工具调用成功,等待用户通过该问题作答;不得同时再输出一套文本选项
34
- - 若工具不存在、工具调用失败或宿主报错,记录“本会话结构化提问不可用”,然后进入文本选项降级模式
33
+ - 若工具不存在或工具调用失败,记录“本会话结构化提问不可用”,然后进入文本选项降级模式
35
34
 
36
35
  ## 最低呈现要求
37
36
 
@@ -1,12 +1,16 @@
1
- # 稳定 CLI 与内部脚本兼容说明
1
+ # 稳定公开 CLI 协议
2
2
 
3
3
  规范路径:`comet/reference/scripts.md`
4
4
 
5
- 本文件是 Comet 公开 CLI 与内部脚本兼容方式的单一事实来源。公开工作流必须优先使用稳定命令面:`comet state`、`comet guard`、`comet handoff`、`comet archive`。
5
+ 本文件是 Classic Skill 调用 Comet Runtime 的单一事实来源。Skill 只使用 PATH 中的公开 `comet` CLI;随包发布的 `comet/scripts/*.mjs` 属于内部安装与 Runtime 资产,不由 Skill 搜索或直接调用。
6
+
7
+ ## CLI 引导
8
+
9
+ 进入 workflow 时直接运行下方所需的公开 `comet` 命令。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整;不得搜索 Skill 文件、枚举平台目录或直接调用内部 bundle。CLI 已启动但返回非零时,报告原错误,不得通过内部脚本重试。
6
10
 
7
11
  ## 公开工作流协议
8
12
 
9
- 正常安装和日常工作流直接使用 `comet` CLI,不需要定位 launcher,也不要向用户暴露内部 `classic` 命名:
13
+ 日常工作流统一调用公开 CLI:
10
14
 
11
15
  ```bash
12
16
  comet state select <change-name>
@@ -16,48 +20,14 @@ comet state check <change-name> <phase>
16
20
  comet guard <change-name> <phase> --apply
17
21
  comet handoff <change-name>
18
22
  comet archive <change-name>
23
+ comet resume-probe . --stdin --json
24
+ comet classic intent route --stdin
19
25
  ```
20
26
 
21
27
  当多个 active change 共存时,进入明确的 change 后先运行 `comet state select <change-name>`。普通源码写入只受该选择管辖;尚未选择时 hook 会阻塞并要求选择。单 active change 可继续自动归属。切换 branch/worktree 或选择失效后必须重新运行 `select`。
22
28
 
23
29
  guard 的 `--apply` 在检查通过后推进状态。需要直接表达状态事件时使用 `comet state transition`;阶段推进后使用 `comet state next` 解析是否自动调用下一 Skill。
24
30
 
25
- ## 兼容、恢复与内部命令引导
26
-
27
- 以下脚本定位只用于旧版兼容、CLI 不可用时的恢复,以及 `/comet-classic` 内部入口命令。正常公开工作流不得优先采用此方式。Comet 脚本随 Skill 包分发在 `comet/scripts/` 下;需要恢复时不要硬编码路径,而应定位一次并缓存环境变量:
28
-
29
- ```bash
30
- COMET_ENV="${COMET_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" "$HOME/.gemini" -path '*/comet/scripts/comet-env.mjs' -type f -print -quit 2>/dev/null)}"
31
- if [ -z "$COMET_ENV" ]; then
32
- echo "ERROR: comet-env.mjs not found. Ensure the comet skill is installed." >&2
33
- return 1
34
- fi
35
- COMET_SCRIPTS_DIR="$(node "$COMET_ENV")"
36
- COMET_STATE="$COMET_SCRIPTS_DIR/comet-state.mjs"
37
- COMET_GUARD="$COMET_SCRIPTS_DIR/comet-guard.mjs"
38
- COMET_HANDOFF="$COMET_SCRIPTS_DIR/comet-handoff.mjs"
39
- COMET_ARCHIVE="$COMET_SCRIPTS_DIR/comet-archive.mjs"
40
- COMET_INTENT="$COMET_SCRIPTS_DIR/comet-intent.mjs"
41
- COMET_RESUME_PROBE="$COMET_SCRIPTS_DIR/comet-resume-probe.mjs"
42
-
43
- # 脚本定位失败时停止流程
44
- if [ -z "$COMET_SCRIPTS_DIR" ]; then
45
- echo "ERROR: Comet scripts not found. Ensure the comet skill is installed." >&2
46
- return 1
47
- fi
48
- ```
49
-
50
- 只有进入上述兼容、恢复或内部命令路径时,Agent 才执行这些变量赋值。`COMET_INTENT` 和 `COMET_RESUME_PROBE` 仍是内部入口引导所需变量,不应全局移除。
51
-
52
- | 变量 | 用途 |
53
- |------|------|
54
- | `COMET_STATE` | `.comet.yaml` 状态读写、phase 检查和恢复上下文 |
55
- | `COMET_GUARD` | 阶段退出守卫和 `--apply` 状态推进 |
56
- | `COMET_HANDOFF` | Design/Build handoff 上下文包生成 |
57
- | `COMET_ARCHIVE` | 一键归档和主 spec 同步 |
58
- | `COMET_INTENT` | `/comet-classic` 入口意图识别和路由评分 |
59
- | `COMET_RESUME_PROBE` | 只读 Ambient Resume 探针,判断是否应恢复 active Comet workflow |
60
-
61
31
  ## 自动状态更新
62
32
 
63
33
  guard 支持 `--apply` 参数,验证通过后自动更新 `.comet.yaml` 状态字段:
@@ -2,7 +2,7 @@
2
2
 
3
3
  规范路径:`comet/reference/subagent-dispatch.md`
4
4
 
5
- 本文档提供在 Superpowers `subagent-driven-development` 技能**之上**应用的 Comet 专属扩展。Superpowers `subagent-driven-development` 技能提供基础连续派发循环(每个 task 派发全新 implementer,并包含默认 task reviewer 节点)并强制连续执行。本文档添加 Comet 特有的真实后台调度、任务追踪、状态验证、上下文恢复,以及审查/修复预算;Comet 的 `review_mode` 接管 reviewer 阶段,决定哪些任务需要 reviewer、需要几轮修复和最终审查。若 Superpowers 技能与本文档发生冲突时,以本文档中更具体的 Comet 约束为准。
5
+ 本文档提供在 Superpowers `subagent-driven-development` 技能**之上**应用的 Comet 专属扩展。Superpowers `subagent-driven-development` 技能提供基础连续派发循环(每个 task 派发全新 implementer,并包含默认 task reviewer 节点)并强制连续执行。本文档添加 Comet 特有的子代理派发、任务追踪、状态验证、上下文恢复,以及审查/修复预算;Comet 的 `review_mode` 接管 reviewer 阶段,决定哪些任务需要 reviewer、需要几轮修复和最终审查。若 Superpowers 技能与本文档发生冲突时,以本文档中更具体的 Comet 约束为准。
6
6
 
7
7
  > **⚠️ 关键约束 — 任务之间禁止暂停**
8
8
  >
@@ -13,7 +13,7 @@
13
13
  > - 存在无法从仓库、计划或既有上下文消除的真实歧义
14
14
  > - 用户**明确**要求暂停
15
15
  >
16
- > 后台调度能力在执行中失效属于运行停止条件,不自动构成新的用户决策点:退出派发循环并返回 `/comet-build` Step 2 的同一个联合决策,移除 `subagent-driven-development`。若只剩一个合法执行方式,说明原因后直接采用;仍有多个合法方式时才等待用户重新选择。
16
+ > 子代理派发操作失败属于运行停止条件,不自动构成新的用户决策点:将当前任务记录为 `BLOCKED` 并写明失败原因,停止派发循环,按当前 change 的阻塞与恢复流程处理;主会话不得接管实现。
17
17
  >
18
18
  > 此规则适用于整个派发循环,而非单个任务。
19
19
 
@@ -33,9 +33,9 @@
33
33
  主会话**仅负责协调**,禁止直接执行 task。主会话禁止修改源代码。协调者唯一允许的文件修改是 plan、OpenSpec task 和 subagent 进度检查点的持久化更新。不得把多个 task 打包给同一个 agent。每个 task 派发一个全新的后台 implementer agent;当 `review_mode` 需要审查或修复时,task reviewer、修复 agent 和 final reviewer 也必须分别使用全新的后台 agent:
34
34
 
35
35
  - **Claude Code**:对每个 implementer,以及 `review_mode` 要求的 task reviewer、修复 agent 和 final reviewer 使用 `Agent` 工具并设置 `run_in_background: true`。禁止内联执行 task,禁止错误进入需要预先创建 team 的团队模式。
36
- - **其他平台**:使用平台等效的后台 agent / Task / 多 agent 派发机制。
36
+ - **其他平台**:使用 agent / Task / 多 agent 派发机制,并按其调度、上下文和结果返回方式执行。
37
37
  - **禁止**跨 task 或角色复用 implementer、reviewer 或修复 agent。每个 agent 拥有全新的隔离上下文,并且只接收当前角色所需的单个 task 上下文。
38
- - 若真实后台派发能力在执行中失效,不得继续派发或由主会话代写实现;返回 `/comet-build` Step 2 的同一个联合决策并移除不可用模式。不得另设“是否改用 executing-plans”的停顿点;只剩一个合法模式时直接采用。
38
+ - 若子代理派发操作失败,不得继续派发或由主会话代写实现;将当前任务记录为 `BLOCKED` 并写明失败原因,按当前 change 的阻塞与恢复流程处理。
39
39
 
40
40
  ### 1. 派发 Prompt 与回报契约
41
41
 
@@ -69,13 +69,12 @@ reviewer prompt 必须保持中立:
69
69
  - 不得在 reviewer prompt 中预判、压低或禁止报告某个发现。若某个可能发现与 plan 冲突,让 reviewer 先报告,再询问用户以哪个要求为准。
70
70
  - 不得把之前 task 的累计历史粘贴进后续派发。只提供当前 task、相关接口/约束,以及已加载的 Superpowers `subagent-driven-development` 技能暴露的交接产物。
71
71
 
72
- **Model 选择(强制)**:每次派发必须显式指定 model,省略会静默继承会话最贵 model,拖慢执行并抬高成本。遵循 Superpowers `subagent-driven-development` 的 Model Selection 规则:
72
+ **Model 选择**:存在 model 选择参数时,为不同角色选择合适的 model;否则直接使用默认 model。不得伪造 model 参数,也不得把缺少选择参数写成阻塞条件。可选择时,遵循 Superpowers `subagent-driven-development` 的 Model Selection 规则:
73
73
 
74
74
  - **implementer / 修复 agent**:用 prose 描述的实现任务至少使用中档;多文件集成、需要模式匹配或调试 → 中档;需要设计判断或广泛理解代码库 → 高档。只有当 plan 文本已含完整待写代码(转写+测试),或只是单文件机械修复时,才用最便宜档。
75
75
  - **reviewer(任务级/最终)**:按 diff 大小、复杂度和风险缩放。小机械 diff 不需要最高档;微妙并发改动才上高档。
76
76
  - **final whole-branch review**:使用可用的最高档 model,不用会话默认档。
77
77
 
78
- 省略 model 等于让它跑会话最贵 model,直接违背本节目标。
79
78
 
80
79
  ### 2. Implementer 范围限制
81
80
 
@@ -97,6 +96,7 @@ implementer 或修复 agent 回报必须提供 **RED 失败命令与失败摘要
97
96
 
98
97
  - 当前 plan task 唯一文本及映射的 OpenSpec task 文本
99
98
  - 当前阶段:`implementing | task-review | checkoff | done | blocked | final-review | final-fix`
99
+ - 本次派发使用的 model(可以识别时)
100
100
  - 实现提交哈希、变更文件和 RED/GREEN 证据
101
101
  - 已选择的 `review_mode`
102
102
  - 已通过的审查阶段及尚未解决的 reviewer 反馈
@@ -143,8 +143,8 @@ Comet 不读取、不写入、也不要求任何 Superpowers `subagent-driven-de
143
143
  4. 运行定向验证:
144
144
 
145
145
  ```bash
146
- comet state task-checkoff <plan-file> <plan-task-text>
147
- comet state task-checkoff <classic-change-dir>/tasks.md <openspec-task-text>
146
+ comet state task-checkoff "<plan-file>" "<plan-task-text>"
147
+ comet state task-checkoff "<classic-change-dir>/tasks.md" "<openspec-task-text>"
148
148
  ```
149
149
 
150
150
  仅在对应映射存在时运行第二条。脚本会要求任务文本恰好出现一次且该项已勾选;验证失败时不得进入下一个 task。
@@ -122,7 +122,7 @@ git commit -m "chore: archive <change-name>"
122
122
  归档提交成功后,只执行 Step 1 中用户已经确认的远端交付方式:
123
123
 
124
124
  - 「确认归档并立即推送」:推送当前绑定分支一次。
125
- - 「确认归档、立即推送并创建 PR」:先推送当前绑定分支一次,再使用当前平台可用的 GitHub 能力创建 PR;Step 1 的明确选择就是创建 PR 的授权,不得再次改成其他分支处置方式。
125
+ - 「确认归档、立即推送并创建 PR」:先推送当前绑定分支一次,再通过已配置的 GitHub 集成创建 PR;Step 1 的明确选择就是创建 PR 的授权,不得再次改成其他分支处置方式。
126
126
 
127
127
  push 失败时报告错误,保留 current selection 记录,不得清除选择或宣告完成;当前任务中只重试同一个 push。PR 创建失败时分支已经包含完整归档提交,报告错误并保留 current selection 记录;当前任务中只重试创建 PR。不得在失败后自动切换、删除、变基或改写分支。
128
128
 
@@ -63,7 +63,7 @@ git rev-parse HEAD
63
63
 
64
64
  将计划写入文件后,返回文件路径。
65
65
 
66
- **执行 subagent**:使用当前平台的 subagent 调度机制派发上述任务。
66
+ **执行 subagent**:将上述任务派发给 subagent。
67
67
 
68
68
  Subagent 完成后:
69
69
  - 若返回有效文件路径且文件存在,记录为 plan
@@ -79,9 +79,9 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
79
79
 
80
80
  无需手动更新 phase,阶段守卫(guard `--apply`)会在退出条件满足后推进 `phase` 字段。
81
81
 
82
- 展示联合决策前先检查当前平台能力:确认 `using-git-worktrees` 是否可用、是否存在真实后台 subagent/Task/multi-agent 调度能力,以及当前仓库能否安全创建分支。只展示当前真实可执行的隔离与执行选项;某个字段只剩一个合法值时说明原因并直接采用,不为单选项制造额外停顿。
82
+ 展示联合决策时,提供本工作流支持的全部工作区隔离和执行方式。不得预检、推断或筛除其他 Skill、分支、worktree、子代理派发或 model 选择能否使用。用户选择后直接执行对应动作;若动作实际失败,停止并报告原错误。某个字段只剩一个工作流合法值时说明原因并直接采用,不为单选项制造额外停顿。
83
83
 
84
- 计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、可用的工作区隔离、可用的执行方式、TDD 模式和代码审查模式。选择 `branch` 时,分支名也必须在 Step 2 的同一个联合决策中确认或由用户覆盖。不得先询问“继续/暂停”,继续后又创建第二个配置或命名阻塞点。
84
+ 计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、工作区隔离、执行方式、TDD 模式和代码审查模式。选择 `branch` 时,分支名也必须在 Step 2 的同一个联合决策中确认或由用户覆盖。不得先询问“继续/暂停”,继续后又创建第二个配置或命名阻塞点。
85
85
 
86
86
  | 选项 | 行为 | 说明 |
87
87
  |------|------|------|
@@ -141,7 +141,7 @@ comet state set <name> build_pause null
141
141
  - 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
142
142
  - 来自 hotfix 路径 → 推荐 B
143
143
 
144
- 这些表格是 Step 2 联合决策的一部分,不再单独暂停。先移除能力预检判定为不可执行的选项;在剩余多个合法选项时,不得根据推荐规则自行选择 `current`、`branch` 或 `worktree`,也不得自行选择执行方式、TDD 模式或代码审查模式。推荐规则只能用于说明建议,不能替代用户确认。
144
+ 这些表格是 Step 2 联合决策的一部分,不再单独暂停。始终展示本工作流支持的隔离和执行选项,不得因预判某个动作会失败而移除选项。在多个合法选项时,不得根据推荐规则自行选择 `current`、`branch` 或 `worktree`,也不得自行选择执行方式、TDD 模式或代码审查模式。推荐规则只能用于说明建议,不能替代用户确认。
145
145
 
146
146
  用户选择后,更新 `isolation`、执行方式、TDD 模式和代码审查模式相关字段:
147
147
 
@@ -150,8 +150,7 @@ comet state set <name> isolation <current|branch|worktree>
150
150
  ```
151
151
 
152
152
  - 若用户选择 `executing-plans`:运行 `comet state set <name> subagent_dispatch null`,再运行 `comet state set <name> build_mode executing-plans`
153
- - 若用户选择 `subagent-driven-development`:先确认当前平台存在可调用的真实后台 subagent / Task / multi-agent 调度能力;确认后先运行 `comet state set <name> subagent_dispatch confirmed`,再运行 `comet state set <name> build_mode subagent-driven-development`
154
- - 若无法确认真实后台调度能力,不得展示或写入 `build_mode: subagent-driven-development`。恢复状态若已记录该模式但能力不可用,回到 Step 2 的同一个联合决策并只展示可执行模式;不得另设“改选 executing-plans”停顿点
153
+ - 若用户选择 `subagent-driven-development`:先运行 `comet state set <name> subagent_dispatch confirmed` 记录已选择子代理执行,再运行 `comet state set <name> build_mode subagent-driven-development`
155
154
 
156
155
  **TDD 模式**:
157
156
 
@@ -174,7 +173,7 @@ comet state set <name> isolation <current|branch|worktree>
174
173
 
175
174
  `isolation` 是脚本级硬约束。full workflow 初始化时可以为 `null`,但只允许存在到本步骤之前。若保持 `null`,`build → verify` 的 guard 和 `comet state transition build-complete` 都会失败。full workflow 允许 `current`、`branch` 或 `worktree`,但 `current` 必须通过用户在 Step 2 显式选择后写入,不得静默默认。
176
175
 
177
- `subagent_dispatch` 是脚本级硬约束。`build_mode: subagent-driven-development` 离开 build 阶段前必须同时满足 `subagent_dispatch: confirmed`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败。
176
+ `subagent_dispatch` 是脚本级硬约束,用于记录用户已选择子代理执行。`build_mode: subagent-driven-development` 离开 build 阶段前必须同时满足 `subagent_dispatch: confirmed`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败;它不是能力检查。
178
177
 
179
178
  `tdd_mode` 是脚本级硬约束。full workflow 离开 build 阶段前 `tdd_mode` 必须已选择为 `tdd` 或 `direct`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败。
180
179
 
@@ -206,7 +205,7 @@ comet state set <name> build_mode direct
206
205
 
207
206
  分支名由 Step 2 确认后,立即执行 `git checkout -b <branch-name>`,然后运行 `comet state set <name> isolation branch`,把新分支写入 `bound_branch`。后续工作在新分支上进行。
208
207
 
209
- - **worktree**:必须使用 Skill 工具加载 Superpowers `using-git-worktrees` 技能创建隔离工作区。禁止用普通 shell 命令或原生工具绕过该技能;如该技能不可用,停止流程并提示安装或启用 Superpowers 技能。
208
+ - **worktree**:**立即执行:** 使用 Skill 工具加载 Superpowers `using-git-worktrees` 技能创建隔离工作区。禁止用普通 shell 命令或原生工具绕过该技能;若加载时因不可用而失败,停止并报告该错误。
210
209
 
211
210
  创建隔离后,确认计划文件可访问(分支方式天然可访问;worktree 方式需确认计划已提交)。若 worktree 模式下计划文件尚未提交,先提交计划文件再创建 worktree:
212
211
 
@@ -225,9 +224,9 @@ comet state select <change-name>
225
224
 
226
225
  **执行计划**:必须按 `build_mode` 的真实运行位置处理。
227
226
 
228
- - `build_mode: executing-plans`:**立即执行:** 使用 Skill 工具加载 Superpowers `executing-plans` 技能。禁止跳过此步骤。若该技能不可用,停止流程并提示安装或启用对应技能,不要用普通对话替代该步骤。技能加载后,ARGUMENTS 必须包含与 Step 1 相同的 Language 约束:`Language: 使用 comet state get <name> language 读取到的 Comet 配置产物语言输出`。按计划执行。
229
- - `build_mode: subagent-driven-development`:主会话只负责协调,禁止直接编写实现代码。**立即执行:** 使用 Skill 工具加载 Superpowers `subagent-driven-development` 技能。技能加载后,读取 `comet/reference/subagent-dispatch.md` 获取 Comet 专属扩展(真实后台调度、任务隔离、勾选验证、TDD 约束、连续执行、上下文恢复),与技能工作流配合应用。若两者发生冲突,以更具体的 Comet 扩展为准。
230
- - 如果执行前复检发现后台调度能力已失效,不得直接在主窗口执行,也不得创建新的二次决策;返回 Step 2 的同一个联合决策,移除不可用模式。用户在该联合决策中选择主窗口执行后,先运行 `comet state set <name> build_mode executing-plans`,再按对应分支继续。
227
+ - `build_mode: executing-plans`:**立即执行:** 使用 Skill 工具加载 Superpowers `executing-plans` 技能。禁止跳过此步骤。若加载失败,停止并报告错误,不要用普通对话替代该步骤。技能加载后,ARGUMENTS 必须包含与 Step 1 相同的 Language 约束:`Language: 使用 comet state get <name> language 读取到的 Comet 配置产物语言输出`。按计划执行。
228
+ - `build_mode: subagent-driven-development`:主会话只负责协调,禁止直接编写实现代码。**立即执行:** 使用 Skill 工具加载 Superpowers `subagent-driven-development` 技能。技能加载后,读取 `comet/reference/subagent-dispatch.md` 获取 Comet 专属扩展(子代理派发、任务隔离、勾选验证、TDD 约束、连续执行、上下文恢复),与技能工作流配合应用。若两者发生冲突,以更具体的 Comet 扩展为准。
229
+ - 若子代理派发操作失败,按 `comet/reference/subagent-dispatch.md` 将当前任务记录为 `BLOCKED` 并带上失败原因;主会话不得接管实现。
231
230
 
232
231
  **TDD 模式执行约束**:
233
232
 
@@ -247,7 +246,7 @@ comet state select <change-name>
247
246
 
248
247
  要求(适用于 `standard` 和 `thorough`):
249
248
  - `requesting-code-review` 技能必须在 `comet guard <change-name> build --apply` 之前加载
250
- - 若 `requesting-code-review` 技能不可用且当前为 `standard` 或 `thorough`,必须停止并请用户选择:安装/启用后重试,或明确切换为 `review_mode: off` 并记录原因。用户未明确切换前不得跳过 review gate 或继续 guard
249
+ - 若当前为 `standard` 或 `thorough` 且加载 `requesting-code-review` 失败,必须停止并请用户选择:解决错误后重试,或明确切换为 `review_mode: off` 并记录原因。用户未明确切换前不得跳过 review gate 或继续 guard
251
250
  - CRITICAL review 发现(安全漏洞、数据丢失风险、构建/测试失败)必须先修复,不得带入 verify
252
251
  - 非 CRITICAL review 发现如选择接受,必须在 tasks.md、commit body、验证报告草稿或其他持久产物中记录接受原因和影响范围
253
252
 
@@ -264,8 +263,8 @@ comet state select <change-name>
264
263
  | 规模 | 触发条件 | 做法 |
265
264
  |------|---------|------|
266
265
  | 小 | 遗漏验收场景、边界条件 | 直接编辑 delta spec + design.md,追加 tasks.md 任务 |
267
- | 中 | 接口变更、新增组件、数据流变化 | **使用当前平台可用的用户输入/确认机制暂停并等待用户确认后**,必须使用 Skill 工具加载 Superpowers `brainstorming` 更新 Design Doc + delta spec |
268
- | 大 | 全新 capability 需求 | **必须使用当前平台可用的用户输入/确认机制暂停并等待用户确认拆分**;用户确认后,通过 `/comet-open` 创建独立 change |
266
+ | 中 | 接口变更、新增组件、数据流变化 | **暂停、展示选择并等待用户明确确认后**,必须使用 Skill 工具加载 Superpowers `brainstorming` 更新 Design Doc + delta spec |
267
+ | 大 | 全新 capability 需求 | **暂停、展示拆分选择并等待用户明确确认**;用户确认后,通过 `/comet-open` 创建独立 change |
269
268
 
270
269
  **50% 阈值判定**:以 tasks.md 初始任务总数为基准,若新增任务数超过该总数的一半,视为超出原计划范围,**必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户决定是否拆分为新 change**。
271
270
 
@@ -30,10 +30,10 @@ agent 做决策只需读本节,参考附录按需查阅。
30
30
 
31
31
  **Step 0: 活跃 Change 发现与意图判定**
32
32
 
33
- 1. 先按 `comet/reference/scripts.md` 完成脚本定位,确保 `$COMET_INTENT` 可用。
33
+ 1. 先按 `comet/reference/scripts.md` 直接运行公开 Comet CLI 命令。
34
34
  2. 运行 `comet classic openspec -- list --json` 获取所有活跃 change。
35
35
  3. 根据用户请求、active change 列表和必要仓库状态填写 `CometIntentFrame`。
36
- 4. 优先用 `node "$COMET_INTENT" route --stdin` 传入 frame JSON,获取 runtime 规范化路由。`CometIntentFrame + runtime scorer` 是事实源;本节自然语言规则只用于意图识别槽位提取。
36
+ 4. 优先用 `comet classic intent route --stdin` 传入 frame JSON,获取 runtime 规范化路由。`CometIntentFrame + runtime scorer` 是事实源;本节自然语言规则只用于意图识别槽位提取。
37
37
  5. 按 runtime route 处理:
38
38
  - `hotfix` → 直接调用 `/comet-hotfix`
39
39
  - `tweak` → 直接调用 `/comet-tweak`
@@ -55,7 +55,7 @@ comet state select <change-name>
55
55
  当用户未显式输入 `/comet-classic`,但当前仓库可能已有 active Comet change 时,开始处理需要改动或调查的任务前先运行只读探针:
56
56
 
57
57
  ```bash
58
- node "$COMET_RESUME_PROBE" probe --stdin
58
+ comet resume-probe . --stdin --json
59
59
  ```
60
60
 
61
61
  探针只读仓库状态,不修改文件。按返回值处理:
@@ -184,7 +184,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
184
184
 
185
185
  流转链:open → design → build → verify → archive
186
186
 
187
- **连续执行要求**:从检测到的阶段开始,agent 自动推进后续阶段。但**自动推进仅适用于没有用户决策的衔接点**。遇到用户决策点时,**必须使用当前平台可用的用户输入/确认机制暂停并等待用户明确回复**,不得用推荐规则、默认值或历史偏好代替用户确认,也不得仅输出文字提示后继续执行。
187
+ **连续执行要求**:从检测到的阶段开始,agent 自动推进后续阶段。但**自动推进仅适用于没有用户决策的衔接点**。遇到用户决策点时,必须提出明确选项并暂停等待用户回复,不得用推荐规则、默认值或历史偏好代替用户确认,也不得仅输出文字提示后继续执行。
188
188
 
189
189
  **阶段推进与自动衔接的区分**:每个子 skill 退出前都会运行阶段守卫 `--apply` 推进 `.comet.yaml` 的 `phase` 字段——这一步**始终发生**,与 `auto_transition` 无关。之后子 skill 运行 `comet state next <name>` 解析下一步:`auto_transition` 不为 `false` 时输出 `NEXT: auto`(自动调用下一 skill),为 `false` 时输出 `NEXT: manual`(不调用下一 skill,按 `HINT` 交还控制权)。`NEXT: manual` 不是用户决策点,不得再询问“是否继续”。因此 `auto_transition` **只控制是否自动调用下一个 skill,不影响 phase 推进**。无论 `auto_transition` 取何值,下方真正的用户决策点都必须阻塞等待。
190
190
 
@@ -194,7 +194,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
194
194
  1. workflow 目标选择:多个 active changes、继续现有 change/创建新 change、或批量拆分完成后选择先启动哪一个
195
195
  2. open 阶段 proposal/design/tasks 最终审视确认(同时确认 change 名称与范围;清晰请求不做前置摘要/命名确认)
196
196
  3. brainstorming 确认设计方案
197
- 4. build 阶段一次性联合选择 plan-ready 暂停或完整工作方式(可用的工作区隔离 + 执行方式 + TDD 模式 + 代码审查模式;选择 branch 时同时确认分支名)
197
+ 4. build 阶段一次性联合选择 plan-ready 暂停或完整工作方式(工作区隔离 + 执行方式 + TDD 模式 + 代码审查模式;选择 branch 时同时确认分支名)
198
198
  5. verify 阶段接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移,或第 4 次失败后选择继续修复/停止;前 3 次明确可修复失败自动闭环
199
199
  6. archive 阶段执行归档脚本前的最终确认
200
200
  7. 归档改动精确提交后选择 finishing-branch 分支处理方式
@@ -202,7 +202,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
202
202
  9. build 阶段范围扩张需重新设计或拆分新 change
203
203
  10. open 阶段大型 PRD 是否拆分为多个 changes
204
204
 
205
- agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须自动继续推进,不得中途退出。到达决策点时,**禁止跳过用户确认或自动选择——必须通过当前平台可用的用户输入/确认机制明确获取用户选择后才能继续**。
205
+ agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须自动继续推进,不得中途退出。到达决策点时,**禁止跳过用户确认或自动选择——必须提出明确选项并获取用户选择后才能继续**。
206
206
 
207
207
  **红旗清单** — 以下想法出现时立即停止并检查:
208
208
 
@@ -269,7 +269,7 @@ agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须
269
269
 
270
270
  ### 脚本定位
271
271
 
272
- 面向 workflow 的状态、守卫、handoff 和 archive 操作统一使用稳定 `comet` CLI;只有尚无公开子命令的 intent/resume probe 才按 `comet/reference/scripts.md` 定位内部 launcher。关键入口:
272
+ 每个会话按 `comet/reference/scripts.md` 直接运行公开 CLI 命令。关键入口:
273
273
 
274
274
  ```bash
275
275
  comet guard <change-name> <phase> --apply # 阶段守卫 + 自动状态更新
@@ -18,7 +18,7 @@ description: "仅在用户明确调用 /comet-design,或由 Comet 根 Skill/ru
18
18
 
19
19
  ### 0. 入口状态验证(Entry Check)
20
20
 
21
- 按 `comet/reference/scripts.md` 定位脚本(定位 `comet-env.mjs`),然后执行入口验证;从任意入口恢复时先按 `comet/reference/context-recovery.md` 运行恢复检查:
21
+ 按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令,然后执行入口验证;从任意入口恢复时先按 `comet/reference/context-recovery.md` 运行恢复检查:
22
22
 
23
23
  ```bash
24
24
  comet state select <change-name>
@@ -149,7 +149,7 @@ brainstorming 产出设计方案后,**必须按 `comet/reference/decision-poin
149
149
 
150
150
  用户确认设计方案后,在创建 Design Doc 前,创建或更新已增量维护的检查点文件,将其定稿为确认后的设计方案摘要:
151
151
 
152
- 使用当前平台的文件能力确保 `<classic-change-dir>/.comet/handoff/` 存在;不要依赖 POSIX 专用目录命令。
152
+ 使用文件工具确保 `<classic-change-dir>/.comet/handoff/` 存在;不要依赖 POSIX 专用目录命令。
153
153
 
154
154
  `<classic-change-dir>/.comet/handoff/brainstorm-summary.md` 结构:
155
155
 
@@ -225,9 +225,9 @@ comet guard <change-name> design --apply
225
225
 
226
226
  只在 **Design Doc 和状态证据落盘后**、进入 Build 前考虑主动式压缩。先确认 `design_doc`、最新 handoff、`handoff_hash` 和 design guard 均已成功持久化;这样压缩后可从文件恢复,不会丢失尚未写入的设计判断。
227
227
 
228
- - 当前平台提供可由 agent 调用的原生压缩机制,且上下文窗口确有压力时,可以触发一次,并在恢复提示中列出 change、下一步和需重新加载的 Design Doc/handoff 文件
229
- - 当前平台只能由用户手动压缩时,给出一次非阻塞建议并继续;**无法程序化触发时不得阻塞**、不得额外制造确认点
230
- - 不得用 shell 命令或摘要替代宿主平台的真实压缩机制
228
+ - 上下文窗口确有压力且存在可调用的原生压缩机制时,可以触发一次,并在恢复提示中列出 change、下一步和需重新加载的 Design Doc/handoff 文件
229
+ - 压缩只能由用户手动触发时,给出一次非阻塞建议并继续;**不得阻塞**、不得额外制造确认点
230
+ - 不得用 shell 命令或摘要伪造上下文压缩
231
231
 
232
232
  ## 退出条件
233
233
 
@@ -26,7 +26,7 @@ description: "仅在用户明确调用 /comet-hotfix,或由 Comet 根 Skill/ru
26
26
 
27
27
  执行链路:open → build → verify → archive。Hotfix 为每个阶段提供默认决策:精简开启、直接构建、按规模验证、验证通过后进入归档前最终确认。
28
28
 
29
- 开始前按 `comet/reference/scripts.md` 定位 Comet 脚本(定位 `comet-env.mjs`);从任意入口恢复时先按 `comet/reference/context-recovery.md` 确认 phase/workflow。
29
+ 开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
30
30
 
31
31
  恢复已有 hotfix change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
32
32
 
@@ -157,7 +157,7 @@ comet guard <change-name> build --apply
157
157
  <IMPORTANT>
158
158
  Hotfix 流程默认 **一次性连续执行**。调用 `/comet-hotfix` 后,agent 在 hotfix 自有步骤间自动推进,不主动停顿。**例外**:若 `auto_transition: false`,则在每个 phase 边界(build/verify/archive 之间)结束当前调用并按 `HINT` 交还控制权,由用户稍后手动运行下一阶段命令;这是手动衔接,不是新的确认点。无论 `auto_transition` 取何值,以下真正的用户决策仍需暂停:
159
159
 
160
- 1. 遇到升级判定信号(见「升级判定」章节),**必须使用当前平台可用的用户输入/确认机制暂停并等待用户明确选择**:继续 hotfix 流程,还是升级为完整 `/comet-classic` 流程
160
+ 1. 遇到升级判定信号(见「升级判定」章节),**必须暂停、展示选择并等待用户明确选择**:继续 hotfix 流程,还是升级为完整 `/comet-classic` 流程
161
161
  2. 验证阶段(comet-verify)接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移或超过自动修复上限后的策略决策;前 3 次明确可修复失败自动闭环
162
162
  3. 归档前最终确认,以及归档提交后的分支处理决策
163
163