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

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 (572) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +37 -33
  3. package/assets/eval-reports/comet-native-vs-beta16-beta17-20260810/native-benchmark-report.html +8 -0
  4. package/assets/eval-reports/comet-native-vs-beta16-beta17-20260810/native-benchmark-report.json +286 -0
  5. package/assets/manifest.json +25 -17
  6. package/assets/skills/comet/SKILL.md +1 -1
  7. package/assets/skills/comet/agents/openai.yaml +3 -0
  8. package/assets/skills/comet/rules/comet-phase-guard.en.md +1 -1
  9. package/assets/skills/comet/rules/comet-phase-guard.md +1 -1
  10. package/assets/skills/comet/rules/comet-workflow-guard.en.md +2 -2
  11. package/assets/skills/comet/rules/comet-workflow-guard.md +2 -2
  12. package/assets/skills/comet/scripts/comet-archive.mjs +65 -65
  13. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +47 -47
  14. package/assets/skills/comet/scripts/comet-guard.mjs +105 -105
  15. package/assets/skills/comet/scripts/comet-handoff.mjs +74 -74
  16. package/assets/skills/comet/scripts/comet-hook-guard.mjs +75 -75
  17. package/assets/skills/comet/scripts/comet-hook-router.mjs +142 -140
  18. package/assets/skills/comet/scripts/comet-resume-probe.mjs +87 -87
  19. package/assets/skills/comet/scripts/comet-runtime.mjs +145 -145
  20. package/assets/skills/comet/scripts/comet-state.mjs +69 -69
  21. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +89 -89
  22. package/assets/skills/comet-any/SKILL.md +2 -1
  23. package/assets/skills/comet-any/agents/openai.yaml +5 -0
  24. package/assets/skills/comet-archive/SKILL.md +7 -6
  25. package/assets/skills/comet-archive/agents/openai.yaml +5 -0
  26. package/assets/skills/comet-build/SKILL.md +14 -13
  27. package/assets/skills/comet-build/agents/openai.yaml +5 -0
  28. package/assets/skills/comet-classic/SKILL.md +14 -14
  29. package/assets/skills/comet-classic/agents/openai.yaml +3 -0
  30. package/assets/skills/{comet → comet-classic}/reference/auto-transition.md +1 -1
  31. package/assets/skills/{comet → comet-classic}/reference/comet-yaml-fields.md +2 -2
  32. package/assets/skills/{comet → comet-classic}/reference/context-recovery.md +5 -5
  33. package/assets/skills/{comet → comet-classic}/reference/debug-gate.md +2 -2
  34. package/assets/skills/{comet → comet-classic}/reference/decision-point.md +1 -1
  35. package/assets/skills/{comet → comet-classic}/reference/dirty-worktree.md +1 -1
  36. package/assets/skills/{comet → comet-classic}/reference/file-structure.md +1 -1
  37. package/assets/skills/{comet → comet-classic}/reference/intent-frame.md +1 -1
  38. package/assets/skills/{comet → comet-classic}/reference/scripts.md +1 -1
  39. package/assets/skills/{comet → comet-classic}/reference/subagent-dispatch.md +1 -1
  40. package/assets/skills/comet-design/SKILL.md +7 -6
  41. package/assets/skills/comet-design/agents/openai.yaml +5 -0
  42. package/assets/skills/comet-hotfix/SKILL.md +10 -9
  43. package/assets/skills/comet-hotfix/agents/openai.yaml +5 -0
  44. package/assets/skills/comet-native/SKILL.md +54 -168
  45. package/assets/skills/comet-native/agents/openai.yaml +3 -0
  46. package/assets/skills/comet-native/reference/artifacts.md +23 -89
  47. package/assets/skills/comet-native/reference/clarification.md +54 -29
  48. package/assets/skills/comet-native/reference/commands.md +30 -173
  49. package/assets/skills/comet-native/reference/recovery.md +38 -88
  50. package/assets/skills/comet-native/reference/workspace.md +23 -0
  51. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +184 -152
  52. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +219 -163
  53. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +126 -117
  54. package/assets/skills/comet-native/scripts/comet-native-init.mjs +134 -124
  55. package/assets/skills/comet-native/scripts/comet-native-new.mjs +170 -163
  56. package/assets/skills/comet-native/scripts/comet-native-next.mjs +179 -148
  57. package/assets/skills/comet-native/scripts/comet-native-root.mjs +152 -147
  58. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +247 -202
  59. package/assets/skills/comet-native/scripts/comet-native-select.mjs +153 -146
  60. package/assets/skills/comet-native/scripts/comet-native-show.mjs +117 -110
  61. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +133 -151
  62. package/assets/skills/comet-native/scripts/comet-native-status.mjs +146 -139
  63. package/assets/skills/comet-open/SKILL.md +7 -6
  64. package/assets/skills/comet-open/agents/openai.yaml +5 -0
  65. package/assets/skills/comet-tweak/SKILL.md +11 -10
  66. package/assets/skills/comet-tweak/agents/openai.yaml +5 -0
  67. package/assets/skills/comet-verify/SKILL.md +9 -8
  68. package/assets/skills/comet-verify/agents/openai.yaml +5 -0
  69. package/assets/skills-zh/comet/SKILL.md +1 -1
  70. package/assets/skills-zh/comet/agents/openai.yaml +3 -0
  71. package/assets/skills-zh/comet-any/SKILL.md +2 -1
  72. package/assets/skills-zh/comet-any/agents/openai.yaml +5 -0
  73. package/assets/skills-zh/comet-archive/SKILL.md +7 -6
  74. package/assets/skills-zh/comet-archive/agents/openai.yaml +5 -0
  75. package/assets/skills-zh/comet-build/SKILL.md +14 -13
  76. package/assets/skills-zh/comet-build/agents/openai.yaml +5 -0
  77. package/assets/skills-zh/comet-classic/SKILL.md +15 -15
  78. package/assets/skills-zh/comet-classic/agents/openai.yaml +3 -0
  79. package/assets/skills-zh/{comet → comet-classic}/reference/auto-transition.md +1 -1
  80. package/assets/skills-zh/{comet → comet-classic}/reference/comet-yaml-fields.md +2 -2
  81. package/assets/skills-zh/{comet → comet-classic}/reference/context-recovery.md +5 -5
  82. package/assets/skills-zh/{comet → comet-classic}/reference/debug-gate.md +2 -2
  83. package/assets/skills-zh/{comet → comet-classic}/reference/decision-point.md +1 -1
  84. package/assets/skills-zh/{comet → comet-classic}/reference/dirty-worktree.md +1 -1
  85. package/assets/skills-zh/{comet → comet-classic}/reference/file-structure.md +1 -1
  86. package/assets/skills-zh/{comet → comet-classic}/reference/intent-frame.md +1 -1
  87. package/assets/skills-zh/{comet → comet-classic}/reference/scripts.md +1 -1
  88. package/assets/skills-zh/{comet → comet-classic}/reference/subagent-dispatch.md +1 -1
  89. package/assets/skills-zh/comet-design/SKILL.md +7 -6
  90. package/assets/skills-zh/comet-design/agents/openai.yaml +5 -0
  91. package/assets/skills-zh/comet-hotfix/SKILL.md +10 -9
  92. package/assets/skills-zh/comet-hotfix/agents/openai.yaml +5 -0
  93. package/assets/skills-zh/comet-native/SKILL.md +54 -168
  94. package/assets/skills-zh/comet-native/agents/openai.yaml +3 -0
  95. package/assets/skills-zh/comet-native/reference/artifacts.md +23 -89
  96. package/assets/skills-zh/comet-native/reference/clarification.md +40 -15
  97. package/assets/skills-zh/comet-native/reference/commands.md +30 -173
  98. package/assets/skills-zh/comet-native/reference/recovery.md +36 -86
  99. package/assets/skills-zh/comet-native/reference/workspace.md +23 -0
  100. package/assets/skills-zh/comet-open/SKILL.md +7 -6
  101. package/assets/skills-zh/comet-open/agents/openai.yaml +5 -0
  102. package/assets/skills-zh/comet-tweak/SKILL.md +11 -10
  103. package/assets/skills-zh/comet-tweak/agents/openai.yaml +5 -0
  104. package/assets/skills-zh/comet-verify/SKILL.md +9 -8
  105. package/assets/skills-zh/comet-verify/agents/openai.yaml +5 -0
  106. package/bin/fast-runtime-router.js +0 -4
  107. package/dist/app/commands/doctor.d.ts.map +1 -1
  108. package/dist/app/commands/doctor.js +8 -0
  109. package/dist/app/commands/doctor.js.map +1 -1
  110. package/dist/app/commands/init.d.ts.map +1 -1
  111. package/dist/app/commands/init.js +9 -1
  112. package/dist/app/commands/init.js.map +1 -1
  113. package/dist/app/commands/update.d.ts.map +1 -1
  114. package/dist/app/commands/update.js +9 -2
  115. package/dist/app/commands/update.js.map +1 -1
  116. package/dist/config/repository-layout.json +0 -8
  117. package/dist/domains/bundle/bundle-platform.d.ts.map +1 -1
  118. package/dist/domains/bundle/bundle-platform.js +8 -0
  119. package/dist/domains/bundle/bundle-platform.js.map +1 -1
  120. package/dist/domains/bundle/types.d.ts +1 -1
  121. package/dist/domains/bundle/types.d.ts.map +1 -1
  122. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  123. package/dist/domains/comet-entry/hook-adapter.js +2 -0
  124. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  125. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  126. package/dist/domains/comet-entry/hook-router-entry.js +11 -2
  127. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  128. package/dist/domains/comet-entry/project-activation.d.ts.map +1 -1
  129. package/dist/domains/comet-entry/project-activation.js +2 -1
  130. package/dist/domains/comet-entry/project-activation.js.map +1 -1
  131. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  132. package/dist/domains/comet-entry/resume-probe.js +48 -4
  133. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  134. package/dist/domains/comet-native/native-acceptance.d.ts +4 -3
  135. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  136. package/dist/domains/comet-native/native-acceptance.js +23 -18
  137. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  138. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  139. package/dist/domains/comet-native/native-archive-command.js +204 -61
  140. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  141. package/dist/domains/comet-native/native-archive-transaction.d.ts.map +1 -1
  142. package/dist/domains/comet-native/native-archive-transaction.js +28 -23
  143. package/dist/domains/comet-native/native-archive-transaction.js.map +1 -1
  144. package/dist/domains/comet-native/native-archive.d.ts +1 -0
  145. package/dist/domains/comet-native/native-archive.d.ts.map +1 -1
  146. package/dist/domains/comet-native/native-archive.js +56 -12
  147. package/dist/domains/comet-native/native-archive.js.map +1 -1
  148. package/dist/domains/comet-native/native-bounded-file.d.ts +32 -2
  149. package/dist/domains/comet-native/native-bounded-file.d.ts.map +1 -1
  150. package/dist/domains/comet-native/native-bounded-file.js +87 -6
  151. package/dist/domains/comet-native/native-bounded-file.js.map +1 -1
  152. package/dist/domains/comet-native/native-build-evidence.d.ts.map +1 -1
  153. package/dist/domains/comet-native/native-build-evidence.js +23 -1
  154. package/dist/domains/comet-native/native-build-evidence.js.map +1 -1
  155. package/dist/domains/comet-native/native-change.d.ts +1 -0
  156. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  157. package/dist/domains/comet-native/native-change.js +96 -8
  158. package/dist/domains/comet-native/native-change.js.map +1 -1
  159. package/dist/domains/comet-native/native-check-executor.d.ts +36 -0
  160. package/dist/domains/comet-native/native-check-executor.d.ts.map +1 -0
  161. package/dist/domains/comet-native/native-check-executor.js +132 -0
  162. package/dist/domains/comet-native/native-check-executor.js.map +1 -0
  163. package/dist/domains/comet-native/native-check-receipt-model.d.ts +9 -0
  164. package/dist/domains/comet-native/native-check-receipt-model.d.ts.map +1 -1
  165. package/dist/domains/comet-native/native-check-receipt-model.js +70 -8
  166. package/dist/domains/comet-native/native-check-receipt-model.js.map +1 -1
  167. package/dist/domains/comet-native/native-check-receipt-storage.d.ts.map +1 -1
  168. package/dist/domains/comet-native/native-check-receipt-storage.js +9 -8
  169. package/dist/domains/comet-native/native-check-receipt-storage.js.map +1 -1
  170. package/dist/domains/comet-native/native-check-receipt.d.ts.map +1 -1
  171. package/dist/domains/comet-native/native-check-receipt.js +123 -60
  172. package/dist/domains/comet-native/native-check-receipt.js.map +1 -1
  173. package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -1
  174. package/dist/domains/comet-native/native-checkpoint-command.js +0 -6
  175. package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -1
  176. package/dist/domains/comet-native/native-checkpoint-storage.d.ts.map +1 -1
  177. package/dist/domains/comet-native/native-checkpoint-storage.js +27 -19
  178. package/dist/domains/comet-native/native-checkpoint-storage.js.map +1 -1
  179. package/dist/domains/comet-native/native-cli-help.d.ts +6 -0
  180. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -0
  181. package/dist/domains/comet-native/native-cli-help.js +192 -0
  182. package/dist/domains/comet-native/native-cli-help.js.map +1 -0
  183. package/dist/domains/comet-native/native-cli-shared.d.ts +2 -2
  184. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  185. package/dist/domains/comet-native/native-cli-shared.js +46 -24
  186. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  187. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  188. package/dist/domains/comet-native/native-cli.js +18 -11
  189. package/dist/domains/comet-native/native-cli.js.map +1 -1
  190. package/dist/domains/comet-native/native-config.d.ts +2 -1
  191. package/dist/domains/comet-native/native-config.d.ts.map +1 -1
  192. package/dist/domains/comet-native/native-config.js +2 -1
  193. package/dist/domains/comet-native/native-config.js.map +1 -1
  194. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  195. package/dist/domains/comet-native/native-continuation.js +175 -147
  196. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  197. package/dist/domains/comet-native/native-diagnostics.d.ts.map +1 -1
  198. package/dist/domains/comet-native/native-diagnostics.js +96 -13
  199. package/dist/domains/comet-native/native-diagnostics.js.map +1 -1
  200. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -1
  201. package/dist/domains/comet-native/native-doctor-command.js +327 -0
  202. package/dist/domains/comet-native/native-doctor-command.js.map +1 -1
  203. package/dist/domains/comet-native/native-doctor.d.ts +1 -0
  204. package/dist/domains/comet-native/native-doctor.d.ts.map +1 -1
  205. package/dist/domains/comet-native/native-doctor.js +116 -22
  206. package/dist/domains/comet-native/native-doctor.js.map +1 -1
  207. package/dist/domains/comet-native/native-evidence-projection.d.ts +50 -0
  208. package/dist/domains/comet-native/native-evidence-projection.d.ts.map +1 -0
  209. package/dist/domains/comet-native/native-evidence-projection.js +284 -0
  210. package/dist/domains/comet-native/native-evidence-projection.js.map +1 -0
  211. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  212. package/dist/domains/comet-native/native-evidence-retention.js +14 -12
  213. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  214. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  215. package/dist/domains/comet-native/native-evidence-storage.js +14 -11
  216. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  217. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  218. package/dist/domains/comet-native/native-findings.js +18 -0
  219. package/dist/domains/comet-native/native-findings.js.map +1 -1
  220. package/dist/domains/comet-native/native-git-provenance.d.ts +16 -0
  221. package/dist/domains/comet-native/native-git-provenance.d.ts.map +1 -0
  222. package/dist/domains/comet-native/native-git-provenance.js +171 -0
  223. package/dist/domains/comet-native/native-git-provenance.js.map +1 -0
  224. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  225. package/dist/domains/comet-native/native-hook-guard.js +159 -18
  226. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  227. package/dist/domains/comet-native/native-init-command.d.ts.map +1 -1
  228. package/dist/domains/comet-native/native-init-command.js +14 -2
  229. package/dist/domains/comet-native/native-init-command.js.map +1 -1
  230. package/dist/domains/comet-native/native-local-execution.d.ts +25 -0
  231. package/dist/domains/comet-native/native-local-execution.d.ts.map +1 -0
  232. package/dist/domains/comet-native/native-local-execution.js +241 -0
  233. package/dist/domains/comet-native/native-local-execution.js.map +1 -0
  234. package/dist/domains/comet-native/native-lock.d.ts +1 -1
  235. package/dist/domains/comet-native/native-lock.d.ts.map +1 -1
  236. package/dist/domains/comet-native/native-lock.js +9 -9
  237. package/dist/domains/comet-native/native-lock.js.map +1 -1
  238. package/dist/domains/comet-native/native-loop-runtime.d.ts +63 -0
  239. package/dist/domains/comet-native/native-loop-runtime.d.ts.map +1 -0
  240. package/dist/domains/comet-native/native-loop-runtime.js +580 -0
  241. package/dist/domains/comet-native/native-loop-runtime.js.map +1 -0
  242. package/dist/domains/comet-native/native-mutation-lock.d.ts +2 -0
  243. package/dist/domains/comet-native/native-mutation-lock.d.ts.map +1 -1
  244. package/dist/domains/comet-native/native-mutation-lock.js +23 -2
  245. package/dist/domains/comet-native/native-mutation-lock.js.map +1 -1
  246. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -1
  247. package/dist/domains/comet-native/native-new-command.js +27 -20
  248. package/dist/domains/comet-native/native-new-command.js.map +1 -1
  249. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  250. package/dist/domains/comet-native/native-next-command.js +114 -63
  251. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  252. package/dist/domains/comet-native/native-paths.d.ts +18 -0
  253. package/dist/domains/comet-native/native-paths.d.ts.map +1 -1
  254. package/dist/domains/comet-native/native-paths.js +125 -13
  255. package/dist/domains/comet-native/native-paths.js.map +1 -1
  256. package/dist/domains/comet-native/native-portable-acceptance.d.ts +28 -0
  257. package/dist/domains/comet-native/native-portable-acceptance.d.ts.map +1 -0
  258. package/dist/domains/comet-native/native-portable-acceptance.js +73 -0
  259. package/dist/domains/comet-native/native-portable-acceptance.js.map +1 -0
  260. package/dist/domains/comet-native/native-portable-archive.d.ts +37 -0
  261. package/dist/domains/comet-native/native-portable-archive.d.ts.map +1 -0
  262. package/dist/domains/comet-native/native-portable-archive.js +492 -0
  263. package/dist/domains/comet-native/native-portable-archive.js.map +1 -0
  264. package/dist/domains/comet-native/native-portable-continuation.d.ts +29 -0
  265. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -0
  266. package/dist/domains/comet-native/native-portable-continuation.js +341 -0
  267. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -0
  268. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts +9 -0
  269. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts.map +1 -0
  270. package/dist/domains/comet-native/native-portable-migration-runtime.js +213 -0
  271. package/dist/domains/comet-native/native-portable-migration-runtime.js.map +1 -0
  272. package/dist/domains/comet-native/native-portable-migration.d.ts +42 -0
  273. package/dist/domains/comet-native/native-portable-migration.d.ts.map +1 -0
  274. package/dist/domains/comet-native/native-portable-migration.js +212 -0
  275. package/dist/domains/comet-native/native-portable-migration.js.map +1 -0
  276. package/dist/domains/comet-native/native-portable-recovery.d.ts +15 -0
  277. package/dist/domains/comet-native/native-portable-recovery.d.ts.map +1 -0
  278. package/dist/domains/comet-native/native-portable-recovery.js +203 -0
  279. package/dist/domains/comet-native/native-portable-recovery.js.map +1 -0
  280. package/dist/domains/comet-native/native-portable-runtime.d.ts +150 -0
  281. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -0
  282. package/dist/domains/comet-native/native-portable-runtime.js +1444 -0
  283. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -0
  284. package/dist/domains/comet-native/native-portable-state.d.ts +30 -0
  285. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -0
  286. package/dist/domains/comet-native/native-portable-state.js +688 -0
  287. package/dist/domains/comet-native/native-portable-state.js.map +1 -0
  288. package/dist/domains/comet-native/native-portable-status.d.ts +62 -0
  289. package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -0
  290. package/dist/domains/comet-native/native-portable-status.js +125 -0
  291. package/dist/domains/comet-native/native-portable-status.js.map +1 -0
  292. package/dist/domains/comet-native/native-portable-text.d.ts +8 -0
  293. package/dist/domains/comet-native/native-portable-text.d.ts.map +1 -0
  294. package/dist/domains/comet-native/native-portable-text.js +28 -0
  295. package/dist/domains/comet-native/native-portable-text.js.map +1 -0
  296. package/dist/domains/comet-native/native-portable-transactions.d.ts +41 -0
  297. package/dist/domains/comet-native/native-portable-transactions.d.ts.map +1 -0
  298. package/dist/domains/comet-native/native-portable-transactions.js +204 -0
  299. package/dist/domains/comet-native/native-portable-transactions.js.map +1 -0
  300. package/dist/domains/comet-native/native-portable-types.d.ts +165 -0
  301. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -0
  302. package/dist/domains/comet-native/native-portable-types.js +18 -0
  303. package/dist/domains/comet-native/native-portable-types.js.map +1 -0
  304. package/dist/domains/comet-native/native-repair-integration.js +5 -5
  305. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  306. package/dist/domains/comet-native/native-resume-view.d.ts.map +1 -1
  307. package/dist/domains/comet-native/native-resume-view.js +1 -5
  308. package/dist/domains/comet-native/native-resume-view.js.map +1 -1
  309. package/dist/domains/comet-native/native-root-move.d.ts.map +1 -1
  310. package/dist/domains/comet-native/native-root-move.js +4 -20
  311. package/dist/domains/comet-native/native-root-move.js.map +1 -1
  312. package/dist/domains/comet-native/native-run-consistency.d.ts.map +1 -1
  313. package/dist/domains/comet-native/native-run-consistency.js +8 -12
  314. package/dist/domains/comet-native/native-run-consistency.js.map +1 -1
  315. package/dist/domains/comet-native/native-run-store.js +4 -4
  316. package/dist/domains/comet-native/native-run-store.js.map +1 -1
  317. package/dist/domains/comet-native/native-runner-input.d.ts +160 -0
  318. package/dist/domains/comet-native/native-runner-input.d.ts.map +1 -0
  319. package/dist/domains/comet-native/native-runner-input.js +347 -0
  320. package/dist/domains/comet-native/native-runner-input.js.map +1 -0
  321. package/dist/domains/comet-native/native-runner-protocol.d.ts +40 -0
  322. package/dist/domains/comet-native/native-runner-protocol.d.ts.map +1 -0
  323. package/dist/domains/comet-native/native-runner-protocol.js +55 -0
  324. package/dist/domains/comet-native/native-runner-protocol.js.map +1 -0
  325. package/dist/domains/comet-native/native-runtime-package.d.ts +3 -0
  326. package/dist/domains/comet-native/native-runtime-package.d.ts.map +1 -1
  327. package/dist/domains/comet-native/native-runtime-package.js +5 -1
  328. package/dist/domains/comet-native/native-runtime-package.js.map +1 -1
  329. package/dist/domains/comet-native/native-schema-migration.d.ts.map +1 -1
  330. package/dist/domains/comet-native/native-schema-migration.js +30 -27
  331. package/dist/domains/comet-native/native-schema-migration.js.map +1 -1
  332. package/dist/domains/comet-native/native-select-command.d.ts.map +1 -1
  333. package/dist/domains/comet-native/native-select-command.js +8 -4
  334. package/dist/domains/comet-native/native-select-command.js.map +1 -1
  335. package/dist/domains/comet-native/native-selection.d.ts.map +1 -1
  336. package/dist/domains/comet-native/native-selection.js +11 -2
  337. package/dist/domains/comet-native/native-selection.js.map +1 -1
  338. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -1
  339. package/dist/domains/comet-native/native-show-command.js +36 -0
  340. package/dist/domains/comet-native/native-show-command.js.map +1 -1
  341. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  342. package/dist/domains/comet-native/native-snapshot.js +13 -10
  343. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  344. package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -1
  345. package/dist/domains/comet-native/native-spec-command.js +14 -28
  346. package/dist/domains/comet-native/native-spec-command.js.map +1 -1
  347. package/dist/domains/comet-native/native-specs.js +3 -3
  348. package/dist/domains/comet-native/native-specs.js.map +1 -1
  349. package/dist/domains/comet-native/native-status-command.d.ts.map +1 -1
  350. package/dist/domains/comet-native/native-status-command.js +7 -17
  351. package/dist/domains/comet-native/native-status-command.js.map +1 -1
  352. package/dist/domains/comet-native/native-status-discovery.d.ts +51 -0
  353. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -0
  354. package/dist/domains/comet-native/native-status-discovery.js +299 -0
  355. package/dist/domains/comet-native/native-status-discovery.js.map +1 -0
  356. package/dist/domains/comet-native/native-trajectory-recovery.d.ts.map +1 -1
  357. package/dist/domains/comet-native/native-trajectory-recovery.js +6 -9
  358. package/dist/domains/comet-native/native-trajectory-recovery.js.map +1 -1
  359. package/dist/domains/comet-native/native-transaction.d.ts.map +1 -1
  360. package/dist/domains/comet-native/native-transaction.js +31 -20
  361. package/dist/domains/comet-native/native-transaction.js.map +1 -1
  362. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  363. package/dist/domains/comet-native/native-transition-evidence.js +1 -0
  364. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  365. package/dist/domains/comet-native/native-transition-journal.d.ts.map +1 -1
  366. package/dist/domains/comet-native/native-transition-journal.js +71 -22
  367. package/dist/domains/comet-native/native-transition-journal.js.map +1 -1
  368. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  369. package/dist/domains/comet-native/native-transitions.js +167 -15
  370. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  371. package/dist/domains/comet-native/native-types.d.ts +36 -1
  372. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  373. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  374. package/dist/domains/comet-native/native-verification-receipt-runtime.js +18 -100
  375. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  376. package/dist/domains/comet-native/native-verification-report-v2.d.ts +12 -0
  377. package/dist/domains/comet-native/native-verification-report-v2.d.ts.map +1 -0
  378. package/dist/domains/comet-native/native-verification-report-v2.js +141 -0
  379. package/dist/domains/comet-native/native-verification-report-v2.js.map +1 -0
  380. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  381. package/dist/domains/comet-native/native-verification-runtime.js +7 -2
  382. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  383. package/dist/domains/comet-native/native-verification-scope.d.ts +23 -0
  384. package/dist/domains/comet-native/native-verification-scope.d.ts.map +1 -1
  385. package/dist/domains/comet-native/native-verification-scope.js +106 -19
  386. package/dist/domains/comet-native/native-verification-scope.js.map +1 -1
  387. package/dist/domains/comet-native/native-verifier-protocol.d.ts +49 -0
  388. package/dist/domains/comet-native/native-verifier-protocol.d.ts.map +1 -0
  389. package/dist/domains/comet-native/native-verifier-protocol.js +157 -0
  390. package/dist/domains/comet-native/native-verifier-protocol.js.map +1 -0
  391. package/dist/domains/comet-native/native-workspace-finish.d.ts +61 -0
  392. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -0
  393. package/dist/domains/comet-native/native-workspace-finish.js +332 -0
  394. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -0
  395. package/dist/domains/comet-native/native-workspace-preparation.d.ts +32 -0
  396. package/dist/domains/comet-native/native-workspace-preparation.d.ts.map +1 -0
  397. package/dist/domains/comet-native/native-workspace-preparation.js +265 -0
  398. package/dist/domains/comet-native/native-workspace-preparation.js.map +1 -0
  399. package/dist/domains/comet-native/native-workspace.d.ts +9 -1
  400. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  401. package/dist/domains/comet-native/native-workspace.js +109 -11
  402. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  403. package/dist/domains/dashboard/native-adapter.d.ts +136 -127
  404. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  405. package/dist/domains/dashboard/native-adapter.js +157 -271
  406. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  407. package/dist/domains/dashboard/native-collector.d.ts +4 -4
  408. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  409. package/dist/domains/dashboard/native-collector.js +230 -412
  410. package/dist/domains/dashboard/native-collector.js.map +1 -1
  411. package/dist/domains/dashboard/native-legacy-adapter.d.ts +30 -0
  412. package/dist/domains/dashboard/native-legacy-adapter.d.ts.map +1 -0
  413. package/dist/domains/dashboard/native-legacy-adapter.js +115 -0
  414. package/dist/domains/dashboard/native-legacy-adapter.js.map +1 -0
  415. package/dist/domains/dashboard/web/assets/{arc-ClrSujVb.js → arc-CkuYweSh.js} +1 -1
  416. package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-B4A_t84A.js → architectureDiagram-3BPJPVTR--tTGrKam.js} +1 -1
  417. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-D72u2953.js → blockDiagram-GPEHLZMM-DLKYOixs.js} +1 -1
  418. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-Ca5zba3N.js → c4Diagram-AAUBKEIU-BL17BIb8.js} +1 -1
  419. package/dist/domains/dashboard/web/assets/channel-Cg__FSMr.js +1 -0
  420. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-CCVPBm0J.js → chunk-2J33WTMH-B_DDS2IK.js} +1 -1
  421. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-JYluRsP-.js → chunk-4BX2VUAB-vQyyh3eG.js} +1 -1
  422. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DfYm7pN7.js → chunk-55IACEB6-Cug8J1Qa.js} +1 -1
  423. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-CwghIMO9.js → chunk-727SXJPM-pMreYMW7.js} +1 -1
  424. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-BA_zgMXZ.js → chunk-AQP2D5EJ-BUkV_rb7.js} +1 -1
  425. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BAJLB5V6.js → chunk-FMBD7UC4-CQXqBSqQ.js} +1 -1
  426. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-Bj6HWRwi.js → chunk-ND2GUHAM-XWLMOyd4.js} +1 -1
  427. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-B1kXfg5N.js → chunk-QZHKN3VN-4drjXzHQ.js} +1 -1
  428. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CsC-pvu9.js +1 -0
  429. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CsC-pvu9.js +1 -0
  430. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-BBrkuiAU.js → cose-bilkent-S5V4N54A-IQKP-hgj.js} +1 -1
  431. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-DlFhgQHt.js → cynefin-VYW2F7L2-CvvRO4J2.js} +1 -1
  432. package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-B0Bk5oiP.js → dagre-BM42HDAG-DeOQo7bP.js} +1 -1
  433. package/dist/domains/dashboard/web/assets/demo-CeIDHUFJ.js +24 -0
  434. package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-tvTUiBA2.js → diagram-2AECGRRQ-IQd_jQwB.js} +1 -1
  435. package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-BZfcK29q.js → diagram-5GNKFQAL-Dllkdt0m.js} +1 -1
  436. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-BQahyP-C.js → diagram-KO2AKTUF-CN_LYqvT.js} +1 -1
  437. package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-D5bJnW2C.js → diagram-LMA3HP47-DK36WkNN.js} +1 -1
  438. package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-DTwWdzWJ.js → diagram-OG6HWLK6-iqUnMYEh.js} +1 -1
  439. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-BbvrdCp9.js → erDiagram-TEJ5UH35-Bc64lzy8.js} +1 -1
  440. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-DgbR7Tcc.js → flowDiagram-I6XJVG4X-UfOqef9j.js} +1 -1
  441. package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-wWMOA7F4.js → ganttDiagram-6RSMTGT7-D-u6Aauc.js} +1 -1
  442. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-DCxvMAUJ.js → gitGraphDiagram-PVQCEYII-CaWEk3PM.js} +1 -1
  443. package/dist/domains/dashboard/web/assets/index-BFwKBVTJ.css +1 -0
  444. package/dist/domains/dashboard/web/assets/{index-Blit0P5Z.js → index-BNyOfAhu.js} +1 -1
  445. package/dist/domains/dashboard/web/assets/index-COZ_03uK.js +257 -0
  446. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-9qXEkzDe.js → infoDiagram-5YYISTIA-BK07mNG0.js} +1 -1
  447. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkf5othW.js → ishikawaDiagram-YF4QCWOH-mWnmaWfZ.js} +1 -1
  448. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C2_IkO4s.js → journeyDiagram-JHISSGLW-BPy-P7xx.js} +1 -1
  449. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BxWgu4DL.js → kanban-definition-UN3LZRKU-3Jq9c_lo.js} +1 -1
  450. package/dist/domains/dashboard/web/assets/{linear-Dkr6p-Ro.js → linear-kQyEW-4G.js} +1 -1
  451. package/dist/domains/dashboard/web/assets/{mermaid.core-DZUcsoG4.js → mermaid.core-COBBjtVH.js} +4 -4
  452. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-C9xyxGfa.js → mindmap-definition-RKZ34NQL-CyyurUpv.js} +1 -1
  453. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-Dn67tdOF.js → pieDiagram-4H26LBE5-CJro_XKk.js} +1 -1
  454. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-Cy6iOcxc.js → quadrantDiagram-W4KKPZXB-CpayUMjH.js} +1 -1
  455. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-B_gZONhx.js → requirementDiagram-4Y6WPE33-Bi8YpfnA.js} +1 -1
  456. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-C3u-4dOk.js → sankeyDiagram-5OEKKPKP-Wx60WwHe.js} +1 -1
  457. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-Xd3ByTVF.js → sequenceDiagram-3UESZ5HK-BiMsRFbc.js} +1 -1
  458. package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CJGHL7Up.js → stateDiagram-AJRCARHV-BrURMY0R.js} +1 -1
  459. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-BpEE-yEg.js +1 -0
  460. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DvONX2YQ.js → timeline-definition-PNZ67QCA-aHrrtV-b.js} +1 -1
  461. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-B-L4qWy4.js → vennDiagram-CIIHVFJN-DGB16bvR.js} +1 -1
  462. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-cf39WX2o.js → wardleyDiagram-YWT4CUSO-RVQbcySh.js} +1 -1
  463. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-Dk1vcm3u.js → xychartDiagram-2RQKCTM6-DMzzwDVX.js} +1 -1
  464. package/dist/domains/dashboard/web/index.html +16 -16
  465. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  466. package/dist/domains/skill/platform-inspect.js +11 -3
  467. package/dist/domains/skill/platform-inspect.js.map +1 -1
  468. package/dist/domains/skill/platform-install.d.ts +7 -1
  469. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  470. package/dist/domains/skill/platform-install.js +114 -33
  471. package/dist/domains/skill/platform-install.js.map +1 -1
  472. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  473. package/dist/domains/skill/uninstall.js +69 -15
  474. package/dist/domains/skill/uninstall.js.map +1 -1
  475. package/dist/domains/workflow-contract/index.d.ts +1 -0
  476. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  477. package/dist/domains/workflow-contract/index.js +1 -0
  478. package/dist/domains/workflow-contract/index.js.map +1 -1
  479. package/dist/domains/workflow-contract/project-config.d.ts +2 -0
  480. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  481. package/dist/domains/workflow-contract/project-config.js +77 -17
  482. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  483. package/dist/domains/workflow-contract/project-gitignore.d.ts +9 -0
  484. package/dist/domains/workflow-contract/project-gitignore.d.ts.map +1 -0
  485. package/dist/domains/workflow-contract/project-gitignore.js +108 -0
  486. package/dist/domains/workflow-contract/project-gitignore.js.map +1 -0
  487. package/dist/platform/install/platforms.d.ts +3 -1
  488. package/dist/platform/install/platforms.d.ts.map +1 -1
  489. package/dist/platform/install/platforms.js +9 -0
  490. package/dist/platform/install/platforms.js.map +1 -1
  491. package/dist/platform/paths/git-worktree.d.ts +2 -1
  492. package/dist/platform/paths/git-worktree.d.ts.map +1 -1
  493. package/dist/platform/paths/git-worktree.js +14 -1
  494. package/dist/platform/paths/git-worktree.js.map +1 -1
  495. package/dist/platform/process/external-command.d.ts +13 -0
  496. package/dist/platform/process/external-command.d.ts.map +1 -0
  497. package/dist/platform/process/external-command.js +45 -0
  498. package/dist/platform/process/external-command.js.map +1 -0
  499. package/dist/platform/process/git.d.ts +12 -0
  500. package/dist/platform/process/git.d.ts.map +1 -0
  501. package/dist/platform/process/git.js +86 -0
  502. package/dist/platform/process/git.js.map +1 -0
  503. package/dist/platform/process/spawn-command.d.ts +8 -0
  504. package/dist/platform/process/spawn-command.d.ts.map +1 -0
  505. package/dist/platform/process/spawn-command.js +113 -0
  506. package/dist/platform/process/spawn-command.js.map +1 -0
  507. package/eval/local/tasks/comet-native-clarification/validation/test_native_clarification.py +9 -21
  508. package/eval/local/tasks/comet-native-clarification-depth/validation/test_native_clarification_depth.py +4 -7
  509. package/eval/local/tasks/comet-native-clarification-modes/validation/test_native_clarification_modes.py +4 -10
  510. package/eval/local/tasks/comet-native-interrupted-transition/instruction.md +1 -1
  511. package/eval/local/tasks/comet-native-interrupted-transition/validation/test_native_interrupted_transition.py +15 -16
  512. package/eval/local/tasks/comet-native-repository-fact/instruction.md +2 -2
  513. package/eval/local/tasks/comet-native-repository-fact/validation/test_native_repository_fact.py +8 -2
  514. package/eval/local/tasks/comet-native-wave-b-decision-resume/instruction.md +8 -4
  515. package/eval/local/tasks/comet-native-wave-b-decision-resume/task.toml +6 -6
  516. package/eval/local/tasks/comet-native-wave-b-decision-resume/validation/test_native_wave_b_decision_resume.py +126 -135
  517. package/eval/local/tasks/comet-native-wave-c-verification-integrity/instruction.md +6 -6
  518. package/eval/local/tasks/comet-native-wave-c-verification-integrity/task.toml +8 -8
  519. package/eval/local/tasks/comet-native-wave-c-verification-integrity/validation/test_native_wave_c_verification_integrity.py +97 -317
  520. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/instruction.md +7 -7
  521. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/task.toml +4 -4
  522. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/validation/test_native_wave_d_stagnation_stop.py +130 -199
  523. package/eval/local/tasks/comet-native-wave-e-parallel-safety/instruction.md +5 -5
  524. package/eval/local/tasks/comet-native-wave-e-parallel-safety/task.toml +8 -8
  525. package/eval/local/tasks/comet-native-wave-e-parallel-safety/validation/test_native_wave_e_parallel_safety.py +135 -239
  526. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/instruction.md +3 -3
  527. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/task.toml +6 -6
  528. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/validation/test_native_wave_f_dashboard_readonly.py +81 -439
  529. package/eval/local/tasks/comet-native-workflow/instruction.md +5 -4
  530. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +145 -502
  531. package/eval/local/tasks/index.yaml +5 -5
  532. package/eval/local/tests/scaffold/test_native_aligned_eval.py +146 -35
  533. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +75 -2054
  534. package/eval/local/tests/scaffold/test_tasks.py +38 -52
  535. package/eval/local/tests/tasks/test_tasks.py +3 -3
  536. package/eval/local/treatments/comet/comet_native_phase1.yaml +7 -4
  537. package/eval/pyproject.toml +4 -4
  538. package/eval/scaffold/python/native_eval.py +10 -5
  539. package/eval/scaffold/python/validation/native_v4.py +249 -0
  540. package/eval/scaffold/python/validation/native_wave.py +4 -5
  541. package/eval/scaffold/python/validation/native_workflow.py +193 -97
  542. package/eval/scaffold/python/validation/rubric.py +114 -1
  543. package/package.json +2 -1
  544. package/assets/skills/comet-native/scripts/comet-native-check.mjs +0 -179
  545. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +0 -179
  546. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +0 -151
  547. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +0 -187
  548. package/dist/domains/comet-native/native-check-entry.d.ts +0 -2
  549. package/dist/domains/comet-native/native-check-entry.d.ts.map +0 -1
  550. package/dist/domains/comet-native/native-check-entry.js +0 -4
  551. package/dist/domains/comet-native/native-check-entry.js.map +0 -1
  552. package/dist/domains/comet-native/native-checkpoint-entry.d.ts +0 -2
  553. package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +0 -1
  554. package/dist/domains/comet-native/native-checkpoint-entry.js +0 -4
  555. package/dist/domains/comet-native/native-checkpoint-entry.js.map +0 -1
  556. package/dist/domains/comet-native/native-evidence-entry.d.ts +0 -2
  557. package/dist/domains/comet-native/native-evidence-entry.d.ts.map +0 -1
  558. package/dist/domains/comet-native/native-evidence-entry.js +0 -4
  559. package/dist/domains/comet-native/native-evidence-entry.js.map +0 -1
  560. package/dist/domains/comet-native/native-receipt-entry.d.ts +0 -2
  561. package/dist/domains/comet-native/native-receipt-entry.d.ts.map +0 -1
  562. package/dist/domains/comet-native/native-receipt-entry.js +0 -4
  563. package/dist/domains/comet-native/native-receipt-entry.js.map +0 -1
  564. package/dist/domains/dashboard/web/assets/channel-B_u-_i2t.js +0 -1
  565. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BpA7BPgX.js +0 -1
  566. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BpA7BPgX.js +0 -1
  567. package/dist/domains/dashboard/web/assets/demo-DZYPLZpF.js +0 -25
  568. package/dist/domains/dashboard/web/assets/index-Bk1o-4VO.css +0 -1
  569. package/dist/domains/dashboard/web/assets/index-g8vyW0R_.js +0 -257
  570. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-rKvBgr6I.js +0 -1
  571. /package/assets/skills/{comet → comet-classic}/reference/classic-layout.md +0 -0
  572. /package/assets/skills-zh/{comet → comet-classic}/reference/classic-layout.md +0 -0
@@ -6,11 +6,11 @@
6
6
 
7
7
  先区分三类信息:
8
8
 
9
- - **可调查事实**:仓库现状、工具能力、依赖默认值和运行环境。由 Agent 调查。
9
+ - **可调查事实**:仓库现状、工具能力、依赖默认值和运行环境。由 Agent 调查;可以将彼此独立的事实调查委派给 subagent。
10
10
  - **用户决定**:不同选择会实质改变输出、默认行为、失败结果、范围或不可逆影响。由用户确认。
11
11
  - **实现选择**:不改变用户可见结果的算法、结构和工作方式。由 Agent 决定。
12
12
 
13
- 只有歧义会实质改变用户可见结果,并且无法从用户要求、正式规格或适用契约中可靠确定时,才询问用户。不要为了覆盖清单制造问题,也不要把实现选择交给用户。
13
+ 只有歧义会实质改变用户可见结果,而且无法从用户要求、正式规格或项目规则中可靠确定时,才询问用户。问题应来自真实分歧;普通实现选择由 Agent 直接决定。
14
14
 
15
15
  把模糊行为改写为可比较的“输入 → 输出”或“触发 → 结果”。每个问题应包含:
16
16
 
@@ -18,34 +18,59 @@
18
18
  - 推荐:首选项及理由;
19
19
  - 影响:各选项对结果的实际影响。
20
20
 
21
- ## Sequential
21
+ ## 如何向用户提问
22
22
 
23
- 1. 调查当前问题依赖的事实。
24
- 2. 找到前置条件已满足且最上游的一个未决问题。
23
+ 到达用户决策点后暂停推进,等待用户明确选择。只有一个合法选项时,说明原因并直接采用;开放式问题或无法准确列出选项的问题使用文本提问。
24
+
25
+ 存在两个或更多清晰、互斥且可执行的选项,并且当前平台提供 `AskUserQuestion` 时,优先使用结构化提问:
26
+
27
+ - Sequential 模式一次提交一个单选或多选问题;
28
+ - Batch 模式在一次请求中提交本轮完整的问题集合;如果工具无法容纳完整集合,整批改用文本提问,不因工具限制拆散本轮问题;
29
+ - 每个选项使用简短标签并说明实际影响;推荐项放在首位并说明理由,推荐不代替用户确认;
30
+ - 工具调用成功后直接等待用户作答,不再输出一套重复的文本选项;
31
+ - 工具不可用或调用失败时,本次会话后续问题直接使用文本方式,不反复尝试同一个工具。
32
+
33
+ 使用文本提问时,明确写出“单选”或“多选”,用编号列出选项、推荐和每项影响,要求用户回复编号,然后暂停等待。
34
+
35
+ ## 决策树与事实调查
36
+
37
+ 在提出第一道用户问题前,先建立并持续维护一棵决策树。树中只包含会实质改变用户可见结果的用户决定;可调查事实作为决定的前置条件,普通实现选择由 Agent 自行处理。
38
+
39
+ 每个决定节点至少写明:要决定什么、它依赖哪个决定、需要先调查哪些事实,以及当前处于等待、可提问还是已解决。依赖的决定和事实都已确定后,该节点才可以向用户提问。同一轮提出的问题必须彼此独立。
40
+
41
+ 决策树只存在于 Agent 的工作过程,不新增 Runtime 文件或状态字段。只有实际未解决的用户问题才用现有 `[blocking]` 行写入 brief。每次用户回答或事实调查产生结论后,立即更新受影响的节点和后续分支,再重新确定当前可以提问的节点。
42
+
43
+ 某项事实尚未确定时,只暂停依赖该事实的节点及其后续分支,其他互不相关的问题继续处理。当前暂时没有可提问节点时,继续调查等待中的事实并检查是否还有遗漏分支。
44
+
45
+ ## Sequential模式
46
+
47
+ 1. 根据决策树调查所需事实,并按上述规则隔离仍在等待事实的分支。
48
+ 2. 从当前可提问节点中选择一个问题;存在多个候选时,优先询问会影响更多后续选择,或对用户可见结果影响更大的问题。
25
49
  3. 在 brief 中保存一项 `- [blocking] <问题>`。
26
- 4. 一次只提出这一道问题并等待回答。
27
- 5. 用户回答后立即更新 Decisions、brief 和完整目标规格,再检查剩余问题。
50
+ 4. 一次只提出一个当前可提问节点并等待回答;下一轮再提出下一个用户决定。
51
+ 5. 用户回答后立即更新 Decisions、brief 和完整目标规格。
52
+ 6. 更新决策树并重新计算当前可提问节点,再开始下一轮。
28
53
 
29
54
  模糊、部分或未回答的内容继续保持 `[blocking]`。一个答案只决定它明确覆盖的行为。
30
55
 
31
- ## Batch
56
+ ## Batch模式
32
57
 
33
- 每轮只提出前置决定和环境事实已经确定、且答案彼此不依赖的问题:
58
+ 每轮从决策树中找出当前可以一起提问的完整问题集合:这些问题所依赖的决定和环境事实已经确定,而且答案彼此不依赖。
34
59
 
35
60
  1. 在 brief 中保存 `- [blocking] Q1: <问题>`、`- [blocking] Q2: <问题>`。
36
- 2. 一次提出本轮全部问题,并分别给出问题、推荐和影响。
61
+ 2. 一次提出本轮全部当前可提问节点,并分别给出问题、推荐和影响。
37
62
  3. 用户回答后更新正式产物;未回答或不明确的问题继续保持 `[blocking]`。
38
- 4. 根据新答案计算下一轮问题。
63
+ 4. 更新决策树中的已回答和未回答节点,再计算下一轮的完整节点集合。
39
64
 
40
- 不要把多个独立决定压缩成一道多选题,也不要把同一批问题拆成多轮。
65
+ 每个独立决定保留为单独问题;同一批互不依赖的问题在一轮中一起提出。
41
66
 
42
67
  ## 持久化与最终确认
43
68
 
44
- 每次确认都立即写入现有 change 的 Decisions 和完整目标规格。不要只更新 brief,不要等到最终确认后再补规格,也不要为补充答案创建新 change。
69
+ 每次确认都立即写入现有 change 的 Decisions 和完整目标规格,并同步更新 brief。补充答案继续写入同一个 change。
45
70
 
46
- 所有已识别问题解决后:
71
+ 只有所有已识别分支都已处理、没有可能改变用户可见行为的待调查事实、当前可提问节点为空,并且未明说的假设也没有产生新问题时,才开始最终确认:
47
72
 
48
- 1. 检查是否仍有静默假设;
73
+ 1. 检查是否仍有可能影响结果但尚未明说的假设;
49
74
  2. 向用户提供目标、范围、关键决定、验收标准和非目标摘要;
50
75
  3. 在 brief 中保存 `- [blocking] CONFIRM: <确认内容>`;
51
76
  4. 等待用户明确确认;
@@ -1,189 +1,46 @@
1
- # Native 命令参考
1
+ # Native 命令与异常参考
2
2
 
3
- 只在需要主 Skill 未列出的参数、receipt、partial scope 或恢复命令时读取本文件。
3
+ 正常流程直接执行 Runtime 在 `continuation` 中给出的命令。本文件用于解释返回字段,以及处理以下情况:命令输入被拒绝、无法启动 Verifier、Verifier 任务执行出错、Verifier 因缺少外部信息无法判断,或 Runtime 要求用户确认降级验收。`continuation.disposition` 说明现在应继续、等待用户、处理阻塞还是结束。只有用户明确确认后,才执行含 `--confirmed` 的后续命令。
4
4
 
5
- ## 项目与 change
6
-
7
- 先判断当前意图;不要按本节顺序逐条执行。只读命令用于确认事实,写命令只在对应条件满足时执行。执行写命令后立即重读 `status <change-name>`,按返回的 phase 和 continuation 决定下一步。
8
-
9
- ### 首次启用 Native
10
-
11
- ```text
12
- comet native init [--root <artifact-root>] [--language en|zh-CN]
13
- ```
14
-
15
- 只在项目尚未启用 Native,或需要补齐 Native 目录与语言配置时使用。它会创建所需目录并写入 `.comet/config.yaml`;已有配置会保留当前 artifact root,但可更新语言。`init` 不迁移已有 artifact root;显式 `--root` 与现有配置冲突时命令会失败。
16
-
17
- 完成后运行 `root show` 确认实际位置。不要在已经存在 change 时把 `init` 当作恢复命令。
18
-
19
- ### 查看或迁移 artifact root
20
-
21
- ```text
22
- comet native root show
23
- comet native root move <artifact-root>
24
- ```
25
-
26
- `artifact-root` 是项目内相对路径。
27
-
28
- - `root show` 是只读命令,返回项目根、配置的 artifact root、实际 Native 目录、语言和未完成迁移。
29
- - `root move` 是事务性写操作,只在用户明确要迁移整个 Native artifact root 时执行;它会移动 Native 数据并更新配置。不要直接编辑配置模拟迁移。
30
-
31
- 迁移未完成时,其他 Native 写操作会被阻塞。先运行只读 `doctor`,再按报告使用 `doctor --repair` 恢复。
32
-
33
- ### 发现并读取 change(只读)
34
-
35
- ```text
36
- comet native status [--cursor <token>]
37
- comet native status <change-name> [--details [--acceptance-cursor <token>]]
38
- comet native show <change-name>
39
- ```
40
-
41
- 无 change 名称的 `status` 返回分页候选。存在多个合理候选时,把候选及 phase 展示给用户选择,不要猜测。
42
-
43
- - `status <change-name>` 返回 phase、revision、检查摘要、下一条命令和 continuation;需要 findings、checkpoint 细节或 acceptance 时加 `--details`。
44
- - `show` 返回 state、brief 和 proposed specs;只在已经确定目标 change 后使用它读取需求与规格,不用它代替 phase/continuation 检查。
45
- - `findingsTruncated` 为 true 时,先处理已返回项,再重新读取。
46
- - `acceptancePage.nextCursor` 非空时,用 `--acceptance-cursor` 继续读取。
47
- - change 集合的 `nextCursor` 非空时,用 `--cursor` 继续读取。
48
-
49
- 这些命令都不修改当前 change、phase 或 change 内容。
50
-
51
- ### 恢复已有 change
5
+ 命令签名和当前参数始终以 CLI 为准:
52
6
 
53
7
  ```text
54
- comet native select <change-name>
8
+ comet native --help
9
+ comet native <command> --help
10
+ comet native <group> <command> --help
55
11
  ```
56
12
 
57
- 只在目标 change 已唯一确定或由用户明确选择后执行。`select` 只更新当前 Native change,不改变 phase;成功结果会返回该 change 的 continuation。
13
+ ## Runtime 返回的下一步
58
14
 
59
- 选择后重新读取 `status <change-name>`,确认 phase,再加载该 phase 对应的 reference。不要把 `select` 当作阶段推进命令。
60
-
61
- ### 创建新 change
62
-
63
- ```text
64
- comet native new <change-name> [--language en|zh-CN] \
65
- [--isolation current|branch|worktree] \
66
- [--change-branch <branch>] \
67
- [--target-branch <branch>]
68
- ```
15
+ - `disposition`:说明现在应该继续、等待用户、处理阻塞还是结束;
16
+ - `commandArgs`:Runtime 要求执行的完整命令参数;
17
+ - `inputOptions`:这次命令需要填写的字段和 JSON 模板;
18
+ - `workspace` / `preparation`:实际工作目录和 change 创建结果;
19
+ - `stateVersion` / `loop`:当前状态版本和验收循环进度;
20
+ - `acceptance` / `nextPageArgs`:验收摘要和下一页的查询命令;
21
+ - `verifierDispatch`:启动独立 Verifier 所需的输入;
22
+ - `workspaceFinishResult` / `recoveryArgs`:归档后的工作区收尾结果和恢复命令。
69
23
 
70
- 只有扫描当前仓库已登记工作目录并确认没有对应 active change 时才运行 `new`。配置缺失时,它会创建默认 Native 配置与 `docs/comet/`;随后创建一个 Shape change、把它设为当前 change,并返回 continuation 和 workspace 绑定。
24
+ 模板中的尖括号表示需要填写的值。`await-user` 表示先等待用户决定,此时不执行推进命令。`localExecution: absent` 只表示这台机器当前没有正在运行的本机任务,不代表 change 已损坏。
71
25
 
72
- `--isolation` 缺省为 `current`。`branch` 和 `worktree` 要求 Agent 先创建/切换实际分支或 worktree,并明确传入创建时所在的 `--target-branch`;Runtime 会核对 `--change-branch` 与当前分支。`worktree` 只能在 linked Git worktree 中创建。新 change 的 workspace 绑定会记录工作方式、change 分支、目标分支和物理工作目录身份,后续写入必须保持一致。
26
+ ## 填写命令输入
73
27
 
74
- 退出码 `73` 且 `error.code: workspace-isolation-required` 表示同一个工作目录已在本次 mutation lock 中发现其他 active change。只有原方式是系统默认 `current` 时才自动改用新 worktree;若用户明确选择的方式失效,重新确认。
28
+ 把 `inputOptions.template` 复制到系统临时 JSON 文件,只替换模板要求填写的内容,然后执行 `continuation.commandArgs`。命令结束后删除临时文件。模板中已有的验收轮次、Verifier 尝试次数、状态版本和任务标识都原样保留;只填写模板公开的字段。
75
29
 
76
- 创建后立即运行 `show <change-name>` 与 `status <change-name>`,然后进入 Shape 澄清与共享理解确认。不要创建新 change 来绕过旧 change 的阻塞、冲突或恢复问题。
30
+ - `builder-handoff`:提交本轮实现摘要、处理的验收 ID、Builder 实际做过的开发检查和已知限制。验收结论留给 Verifier。
31
+ - `dispatch-verifier`:列出当前候选需要由 Runtime 执行的检查。确认没有适用的命令检查时提交空列表。
32
+ - `verifier-response`:Verifier 请求补充检查,或提交覆盖全部验收 ID 的最终结果。
33
+ - `verifier-execution-error` / `verifier-unavailable`:报告 Verifier 任务执行出错或无法启动。模板中的任务关联字段必须原样保留,避免旧任务的迟到消息影响新的 Verifier。
77
34
 
78
- ### 修正规格轨迹
79
-
80
- ```text
81
- comet native spec remove <change-name> <capability>
82
- comet native spec rebase <change-name> --summary <text>
83
- ```
84
-
85
- 这两条都不是普通文件编辑命令。`spec remove` 把 capability 记录为待移除的规格操作;只在目标行为确实要求移除该 capability 时使用。`spec rebase` 只处理 canonical 规格发生并发变化的情况:先重读 canonical 规格并改写完整目标规格,再用摘要记录 rebase 原因。
86
-
87
- `spec remove` 和 `spec rebase` 都会修改 change 的规格轨迹并返回新的 continuation。执行后立即重读 `status <change-name>`;不要手改 operation、base hash 或 Runtime 状态。
88
-
89
- ## Checkpoint 与检查
90
-
91
- ```text
92
- comet native checkpoint <change-name> \
93
- --summary <text> \
94
- --next-action <text> \
95
- [--artifact <project-relative-path>]... \
96
- [--expect-revision <n>]
97
-
98
- comet native check <change-name>
99
- comet native evidence format [--entries <path>]
100
- ```
101
-
102
- checkpoint 只保存恢复摘要和真实产物引用,不改变 phase,也不能代替完成证据。
103
-
104
- `check` 是 Native 内置检查,不替代项目测试。发现问题或证据失效时返回退出码 `1`。
105
-
106
- `evidence format` 从 stdin 或 `--entries` 读取验收条目,输出可原样粘贴到 `verification.md` 的规范机器块。
107
-
108
- 提交 `pass` 时,Runtime 会先校验报告格式、完整验收矩阵和 acceptance receipt;只有校验通过后才执行或复用当前 scope 的内置 required check。报告校验失败时先按错误信息修正 `verification.md`,不要重复提交同一个 `next`。`next` 不接受 `--receipt`,也不需要调用方传入 required-check receipt。
109
-
110
- ## Acceptance receipt
111
-
112
- 自动验证:
113
-
114
- ```text
115
- comet native receipt automated <change-name> \
116
- [--acceptance <id>]... \
117
- [--timeout-ms <milliseconds>] \
118
- -- <executable> [args...]
119
- ```
120
-
121
- 人工观察:
122
-
123
- ```text
124
- comet native receipt manual <change-name> \
125
- --acceptance <id>... \
126
- --step <text> \
127
- --observation <text>
128
- ```
129
-
130
- 只为真实执行的命令或人工观察生成 receipt。失败、跳过、阻塞或超时结果不能作为 pass。
131
-
132
- 批量刷新过期 receipt:
133
-
134
- ```text
135
- comet native receipt refresh <change-name> [--apply]
136
- ```
137
-
138
- receipt 绑定生成时的 revision、contract、scope、snapshot 与 artifact。任何一次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,导致此前签发的 receipt 绑定过期。`next --result` 会因此报 `verification-receipt-binding-mismatch` 并列出每个过期 receipt 及其不一致字段。
139
-
140
- 不带 `--apply`(默认)为预览:只报告哪些 manual receipt 过期、哪些 automated receipt 需重跑、哪些 required-check receipt 需用 `comet native check` 重生成,不改动任何文件。
141
-
142
- 带 `--apply` 时:只对绑定不一致仅限于 `sourceRevision` 的过期 manual receipt 按当前 revision 重新签发,并把规范证据块写回 verification.md 的 `# Acceptance evidence` 段;contract、scope、snapshot 或 artifact 不一致仍会阻塞并要求重新人工验证。automated receipt 不会被静默重签(它证明一次真实命令执行),refresh 只报告需重跑的命令让你用 `receipt automated` 重新执行。
143
-
144
- ## 阶段推进
145
-
146
- ```text
147
- comet native next <change-name> --summary <text> \
148
- [--confirmed] \
149
- [--artifact <project-relative-path>]... \
150
- [--no-code-reason <text>] \
151
- [--allow-partial-scope <sha256> --partial-reason <text> --confirmed] \
152
- [--result pass|fail] \
153
- [--report <change-relative-path>] \
154
- [--override-repair <sha256> --override-summary <text>]
155
-
156
- comet native archive <change-name> --dry-run [--finish merge|push|pull-request|keep]
157
- comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
158
- ```
159
-
160
- - Shape:只有用户确认最终共享理解后才传 `--confirmed`。
161
- - Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。如果需求变化引入新的用户决定,先保持在 Build 并重新完成澄清与确认;确认后更新正式产物,再执行 Runtime 返回的 transition 命令并传入 `--confirmed`。
162
- - Partial scope:先向用户说明 Runtime 返回的具体缺口和风险。超出已返回明细预算的变化由 `scope-detail-overflow` 数量和内容 hash 汇总;只有用户接受后才使用完全匹配的 scope hash、理由和 `--confirmed`。
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 自动推导。
164
- - Repair override:只使用 status 返回的 signature,并且只在有一个明确新修复假设时执行。
165
- - Archive:current 直接 dry-run;branch/worktree 在用户完成联合收尾选择后,用 `--finish` 把选择持久化并生成新的 preflight。后续使用本次预演返回的精确 preflight hash;`required` 模式还需要用户明确确认。不得把 `--finish` 与 `--expect-preflight` 同时传入。
166
-
167
- ## 诊断与恢复
168
-
169
- ```text
170
- comet native doctor [<change-name>]
171
- comet native doctor [<change-name>] --repair
172
- comet native doctor [<change-name>] --repair [--strategy continue|rollback]
173
- ```
35
+ Runtime 负责执行并记录验收检查。Builder 在 handoff 中列出的开发检查只用于说明候选;Verifier 以 Runtime 的实际检查结果为准。是否补充检查、重试或启动新的 Verifier,由最新 `continuation` 决定。
174
36
 
175
- 先运行只读 doctor。只有报告给出可修复动作时才使用 `--repair`。普通阶段 transition 只支持 `continue`;Archive 或 root move 是否允许 rollback 以 doctor 返回为准。
37
+ ## 异常情况
176
38
 
177
- ## 输出与退出码
39
+ - 无法启动独立 Verifier:先确认适用检查已经列明,且 Runtime 检查全部通过;随后按模板报告 unavailable,等待用户决定是否接受只有命令检查、没有独立语义验收的降级结果。
40
+ - Verifier 暂时无法判断(`semantic blocked`):如果只缺用户或外部信息,执行 Runtime 返回的解决动作;如果需要修改实现,回到 Build。
41
+ - 由 Skill 协调的 Verifier 判断全部通过(`skill-coordinated pass`):Runtime 要求用户确认时解释一次验收边界,用户确认后执行返回的命令。
42
+ - Verifier 任务执行出错(`execution error`):按模板提交错误,再读取新的 `continuation`。Runtime 决定复用哪些检查以及是否重试。
178
43
 
179
- 所有命令支持 `--json`。JSON 模式返回一个包含 `command`、`exitCode`、`data`,以及失败时 `error` 的对象。
44
+ ## 诊断
180
45
 
181
- | 退出码 | 含义 |
182
- | --- | --- |
183
- | `0` | 成功 |
184
- | `1` | 内置检查发现问题或结果失效 |
185
- | `64` | 参数或用法错误 |
186
- | `65` | 配置、状态或产物无效 |
187
- | `73` | 锁、事务、并发或根目录冲突 |
188
- | `75` | repair stagnation 或失败预算阻塞继续 |
189
- | `70` | 未预期的内部失败 |
46
+ 先运行只读 `doctor`。只有 `doctor` 明确给出修复命令时才执行;锁、跨设备状态和事务仍由 Runtime 管理。
@@ -1,117 +1,67 @@
1
1
  # Native 恢复参考
2
2
 
3
- 只在 Runtime 报告中断、失效证据、repair stop、冲突、锁、迁移或损坏状态时读取本文件。
3
+ 只在 Runtime 报告本机任务中断、Runtime 文件缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏时读取。
4
4
 
5
5
  ## 通用原则
6
6
 
7
- 先停止写入并运行只读诊断:
7
+ 先停止修改项目,再重新运行 `status --details --json` 和只读 `doctor`。只执行 `continuation` 或 `doctor` 明确返回的恢复动作。跨设备状态、本机任务、锁和事务始终交给 Runtime 管理;无法确定自动恢复是否安全时,保留现场并等待用户。
8
8
 
9
- ```text
10
- comet native doctor [<change-name>]
11
- ```
9
+ ## Workspace
12
10
 
13
- 只根据 doctor 或 continuation 返回的事实采取动作。不要手改状态、hash、证据、锁或事务文件;Runtime 无法证明自动修复安全时,保留现场并等待用户。
11
+ `status` 会跨已登记的 worktree 查找与当前绑定一致的 change,并返回实际工作目录 `workspace.projectRoot`。进入该目录并重新执行 `select`。恢复应沿用找到的 change 和工作目录,不复制 change,也不在其他目录重建同名 change。
14
12
 
15
- ## 工作区提示
13
+ 如果项目根目录、分支、工作区类型或 Git 状态与 `comet-state.yaml` 中的记录不一致,Runtime 会阻止写入。Runtime 能安全找到或创建已声明的 worktree 时,按返回动作继续;否则进入等待用户(`await-user`)。
16
14
 
17
- 先用 `git worktree list --porcelain` 和每个安全可访问目录中的 `comet native status --project-root <path> --json` 查找 change 的实际工作目录。不要复制 active change 目录、不要在另一个 worktree 重建同名 change,也不要通过改 `workspace.json` 接管。
15
+ 原目录或分支确实丢失时,由用户决定使用哪个恢复目录、是否从可信备份重建,或是否放弃 change。
18
16
 
19
- 旧元数据的 `workspace-root-changed` 与 `workspace-inspection-unavailable` 只用于解释当前 root 事实的来源,不单独阻止推进或 Archive。新绑定的以下错误会阻止写入:
17
+ ## 稳定状态与本机任务
20
18
 
21
- - `workspace-binding-root-changed`:当前物理工作目录不是创建 change 的目录;
22
- - `workspace-branch-changed`:当前分支不是绑定的 change 分支;
23
- - `workspace-kind-changed`:绑定为 worktree,但当前目录不再是 linked worktree;
24
- - `workspace-vcs-unavailable`:绑定所需的 Git 工作目录不可用。
19
+ `comet-state.yaml` 记录最后一个可以安全恢复的工作流状态。本机 `state.json` 只说明这台机器正在执行什么;如果它缺失、版本落后或属于旧任务,Runtime 会根据 YAML、brief 和目标 Spec 重建。本机状态不能覆盖版本更新的 YAML。
25
20
 
26
- 找到登记中的原工作目录后,在其中恢复并重新 `select`。原目录或分支确实丢失时保留 artifacts,先运行只读 doctor;Runtime 没有证明可修复时停止并让用户决定恢复目录、从可信备份重建,或放弃 change。不要把任意 `workspace-*` finding 都当作提示,也不要自动刷新 baseline。
21
+ - Shape:保持 Shape,继续澄清或确认。
22
+ - Build:如果 Runtime 显示 `repairing`,表示 Verify 未通过后已返回 Build。保持当前验收轮次,根据 Builder handoff、未解决的验收项和下一步继续。
23
+ - Verify(`verify-ready`):重新运行当前候选的必要检查,并启动新的 Verifier;旧设备上的通过结果不再沿用。
24
+ - Archive(`archive-ready`):先安全返回 Verify,把验收结果重置为待检查(`pending`),再验收已经同步到新设备的实现。
25
+ - 等待用户或阻塞(`await-user` / `blocked`):恢复原来的阻塞原因、负责处理的人和允许动作,等待对应条件满足后再继续。
26
+ - active 目录中的 `done`:只完成可以确定的目录移动与清理。
27
+ - archive 目录中的 `done`:以只读方式展示,这个 change 已经结束。
27
28
 
28
- `workspace-isolation-required` 发生在新建竞态:系统默认 `current` 可自动准备独立 worktree 后重试;显式用户选择失效时重新确认。
29
+ 旧任务的进程、日志连接和 Agent 会话都视为已经丢失,不能根据残留文件猜测它们是否成功。检查已经结束但 YAML 尚未记录结果时,只有可以安全重复的检查才会重跑;可能产生重复副作用的外部动作转为等待用户。
29
30
 
30
- ## 未完成的阶段推进
31
+ `verification.md` 缺失、写入中断或 `generated_from_state_version` 落后时,只根据 YAML 重建报告。YAML 仍是恢复依据;报告版本对齐后才能授权 Archive。
31
32
 
32
- status 或 doctor 报告未完成 transition 时,优先按 continuation 重试原动作。需要显式修复时:
33
+ 旧版本的 active change 会以只读状态显示 `migration-required`。使用 `doctor --repair` 或 Runtime 明确返回的迁移命令处理;迁移失败时保留旧文件,等待 Runtime 给出下一步。
33
34
 
34
- ```text
35
- comet native doctor <change-name> --repair --strategy continue
36
- ```
35
+ ## 零聊天上下文与跨设备
37
36
 
38
- 普通 Shape、Build、Verify transition 只支持 continue,不支持 rollback。
37
+ 在没有聊天记录的新设备上恢复时,需要取得同一份已同步项目代码、`comet-state.yaml`、brief 和目标 Spec。如果 change 使用非默认产物目录,还需要同步 `.comet/config.yaml`。
39
38
 
40
- ## Baseline 缺失或不完整
39
+ 先停止旧设备上的推进并完成同步。发现 Git 冲突,或同一状态版本出现两份不同内容时,进入阻塞状态并交给用户处理。
41
40
 
42
- `baseline-snapshot-missing` 或 `baseline-snapshot-incomplete` 不能用当前文件重建,也不能通过手改 evidence 修复。
41
+ 旧设备上尚未同步的代码无法随工作流状态恢复,同一个 subagent 任务也不能跨设备继续。新设备根据 YAML 中的工作目录、验收循环、验收结果、阻塞原因、Builder handoff 和下一步创建新的本机任务;如果同步后的实现不完整,新的 Verifier 会指出缺口并返回 Build。
43
42
 
44
- 只能:
43
+ Verify 或待归档状态在新设备上重新验收,属于恢复过程:它不会增加验收轮次、失败轮次或停滞计数;只有实际启动新的 Verifier 时,Verifier 尝试次数才增加。已经完成的 Shape 和 Build 不会重做,Runtime 也不会扫描整个项目来猜测进度。
45
44
 
46
- 1. 从可信备份恢复原 baseline;或
47
- 2. 保留用户已写的 brief、规格和实现事实,重新创建 change。
45
+ ## Verify 未通过与持续无进展
48
46
 
49
- ## 证据失效
47
+ Verify 未通过后,读取未通过、暂时无法验证的验收项以及失败检查。完成实际修改后,再提交新的 Builder handoff。只有未解决的问题变少才算有进展;只改说明文字、重复相同检查或再次报告同一原因,不算解决问题。
50
48
 
51
- brief、规格、实现、报告或 receipt 改变后,旧 scope 或 Verify pass 可能失效。按 continuation 回到 Build,重新确认发生变化的用户行为、生成新 scope 并重新验证。不要复用旧 pass 或旧 preflight。
49
+ 连续多轮没有进展,或 Verifier 任务多次执行出错时,按 Runtime 返回的阻塞处理动作继续。失败轮次达到 `native.max_verify_failures` 时进入等待用户,让用户选择继续当前目标、修改已经确认的需求或停止。
52
50
 
53
- receipt 与 revision 绑定:每次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,此前签发的 receipt 会因此绑定过期。`next --result` 报 `verification-receipt-binding-mismatch` 时,finding 会列出每个过期 receipt 及其不一致字段(如 `sourceRevision: expected 6, got 5`),并给出恢复命令。只有 manual evidence 仅发生 sourceRevision 不一致时,才可以不回到 Verify,运行 `comet native receipt refresh <change> --apply` 按当前 revision 重签并写回 verification.md;contract、scope、snapshot 或 artifact 不一致都必须重新验证。automated receipt 必须用 `receipt automated` 重新执行原命令,不能静默重签。
51
+ 用户确认新的验收清单并开始一轮新目标后,验收失败计数清零。
54
52
 
55
- ## Verify fail 与 repair stop
53
+ ## 规格与 Archive 冲突
56
54
 
57
- Verify fail 回到 Build 后:
55
+ 如果项目中已经归档的正式 Spec 在当前 change 期间发生变化,重读最新正式 Spec、brief 和当前 change 的完整目标规格,按用户意图改写后执行 Runtime 冲突信息中给出的重新对齐(rebase)动作,再重新实现和验收。并发产生的新内容应保留。
58
56
 
59
- 1. 从 status details 读取 failed/missing acceptance 和 failed check;
60
- 2. 实际修复这些缺口;
61
- 3. 重新运行相关验证;
62
- 4. 再提交 Verify 结果。
57
+ 两个 active change 同时修改同一功能区域(capability)时,Archive 会进入等待用户。用户决定先归档哪一个,另一个 change 随后重新对齐最新 Spec。
63
58
 
64
- 相同缺口第三次出现时,Runtime 返回 `repair-stagnation-stop`。这不是用户决策:Agent 从 status 读取 signature,提出一个与上一轮不同且具体的新的修复假设,完成对应修改后,使用该 signature 和假设摘要执行一次 repair override。不要让用户提供 signature、hash 或 override 参数。
59
+ Archive 或 change 目录移动中断时,以 `doctor` 返回的事务状态和允许动作作为恢复依据。路径、工作流状态和实际文件互相对不上时,保留两侧现场并等待明确的恢复动作。
65
60
 
66
- override 已耗尽或达到 `native.max_verify_failures` 时,continuation 返回 `await-user` 和 `repair-continuation-decision`。向用户说明当前失败和已尝试方案,只让用户选择:
61
+ 若工作区收尾结果 `workspaceFinishResult.status` 为阻塞(`blocked`),change 可能已经完成归档或 Git 提交。先执行 `recoveryArgs` 检查实际 Git 状态,再根据返回结果决定下一步。
67
62
 
68
- 1. 继续尝试:由 Agent 提高 `native.max_verify_failures` 后继续;
69
- 2. 调整已确认契约:回到 Shape 更新 brief 和完整目标规格,并重新确认;
70
- 3. 停止本次修复:保留 change 和当前现场,不继续推进或 Archive。
63
+ ## 损坏状态
71
64
 
72
- 用户只做方向选择;Agent 负责修改配置或正式产物、读取 Runtime signature,并执行后续命令。
73
-
74
- ## Canonical spec 冲突
75
-
76
- Archive 报告 canonical spec 已变化时:
77
-
78
- 1. 重读最新 canonical spec、brief 和拟议完整规格;
79
- 2. 按用户意图改写完整目标规格;
80
- 3. 运行:
81
-
82
- ```text
83
- comet native spec rebase <change-name> --summary <摘要>
84
- ```
85
-
86
- 4. 按 Runtime 返回的 phase 重新实现、确认和验证。
87
-
88
- 不要手改 `base_hash` 或覆盖并发变化。
89
-
90
- ## Archive 中断
91
-
92
- 先运行 doctor,确认 transaction 和允许的恢复方向:
93
-
94
- ```text
95
- comet native doctor <change-name>
96
- comet native doctor <change-name> --repair --strategy continue
97
- comet native doctor <change-name> --repair --strategy rollback
98
- ```
99
-
100
- - `continue`:继续完成归档;
101
- - `rollback`:恢复 active change;
102
- - doctor 未提供 rollback 时,不要自行回退。
103
-
104
- 出现 journal 与实际文件不一致、路径冲突或无法证明安全时,保留所有相关目录并停止自动修复。
105
-
106
- ## Artifact root 迁移中断
107
-
108
- 存在 `pending_root_move` 时,普通 Native 写命令会停止。运行 doctor,并只执行报告允许的 continue 或 rollback。
109
-
110
- 如果旧 root 与新 root 不一致,不删除任何一棵目录;把 doctor 返回的两条路径交给用户处理。
111
-
112
- ## 锁、当前 change 或损坏产物
113
-
114
- - 不手动删除锁。只在 doctor 明确判断可安全接管时使用 `--repair`。
115
- - doctor 可以清理指向不存在 change 的当前 change 记录。
116
- - 损坏的 config、change 状态、brief、规格或 verification 不会被自动猜测重写。
117
- - doctor 无法确定 owner、事务或文件身份时,保留现场并停止。
65
+ - 锁由 Runtime 管理;只有 `doctor` 明确给出命令时才修复。
66
+ - config、change、brief、规格或 verification 损坏时,保留原文件并等待 `doctor` 或用户给出恢复来源。
67
+ - 同一个 change 同时出现在 active 和 archive、无法确定文件归属,或无法判断事务进行到哪一步时,保留现场并停止写入。
@@ -0,0 +1,23 @@
1
+ # Native 工作区选择参考
2
+
3
+ 只在创建 change 时读取。用户已经指定 `current`、`branch` 或 `worktree` 时直接采用。
4
+
5
+ 未指定隔离方式时,出现以下任一情况才询问用户:
6
+
7
+ - 当前目录有未提交工作;
8
+ - 已有其他 active Native change;
9
+ - 用户要求并行开发或隔离工作,但没有指定方式。
10
+
11
+ 没有这些情况时使用 Runtime 默认的 `current`。
12
+
13
+ 需要询问时,把隔离方式作为一个单选决策点:
14
+
15
+ | 选项 | 方式 | 实际影响 |
16
+ | --- | --- | --- |
17
+ | A | 当前目录(`current`) | 沿用当前分支和目录,不创建新的 Git 分支或工作目录 |
18
+ | B | 新分支(`branch`) | 在当前目录切换到新的 change 分支;要求当前工作区干净 |
19
+ | C | 新 worktree(`worktree`) | 创建独立分支和工作目录,适合并行 change 或当前目录已有未提交工作 |
20
+
21
+ 展示与当前状态和用户要求一致的全部合法选项,不因预判后续命令可能失败而额外筛选。用户明确要沿用当前分支时推荐 A;需要独立分支且无需并行工作时推荐 B;需要并行开发、当前目录已有工作,或已有 active Native change 时推荐 C。
22
+
23
+ 推荐只作说明,等待用户选择后再创建。提问方式遵循[澄清参考](clarification.md):优先使用结构化单选工具;工具不可用时使用编号文本并暂停等待。只有一个合法选项时,说明原因并直接采用。
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: comet-open
3
- description: "仅在用户明确调用 /comet-open,或由 Comet 根 Skill/runtime 路由到 open 阶段时使用;创建或恢复 OpenSpec change,并补齐 proposal/design/tasks/.comet.yaml。"
3
+ description: "Comet Classic 阶段 1 —— 开启 OpenSpec change 并建立 proposal/design/tasks/.comet.yaml 产物。"
4
+ disable-model-invocation: true
4
5
  ---
5
6
 
6
7
  # Comet 阶段 1:开启(Open)
7
8
 
8
- 开始或恢复前必须先读取并执行 `comet/reference/classic-layout.md`;本文件中的 OpenSpec CLI 调用必须使用 adapter,文件路径必须使用该协议绑定的 `<classic-*>` 逻辑根。
9
+ 开始或恢复前必须先读取并执行 `comet-classic/reference/classic-layout.md`;本文件中的 OpenSpec CLI 调用必须使用 adapter,文件路径必须使用该协议绑定的 `<classic-*>` 逻辑根。
9
10
 
10
11
  ## 前置条件
11
12
 
@@ -75,7 +76,7 @@ comet classic openspec -- --version
75
76
  - 预计会产生多个 delta spec 或超过 3 个大任务
76
77
  - 任一部分失败或延期不应阻塞其他部分进入后续阶段
77
78
 
78
- 如推荐拆分,必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户选择。
79
+ 如推荐拆分,必须按 `comet-classic/reference/decision-point.md` 的协议暂停并等待用户选择。
79
80
 
80
81
  用户选择必须包含:
81
82
  - 「创建多个 OpenSpec changes」— 按候选拆分逐个创建独立 change
@@ -119,7 +120,7 @@ comet state check <name> design
119
120
  - **范围与命名都明确时直接继续**,不得仅为了让用户批准摘要或名称而创建停顿点;最终审视会统一确认 change 名称、范围和产物内容
120
121
  - 用户已经提供名称时,规范化为 kebab-case 并在进度说明中回显;规范化不改变含义时无需再次确认
121
122
  - 已确认批量拆分项直接复用批量清单中的摘要与名称;检测到范围漂移或清单信息缺失时,才重新澄清
122
- - 只有仍存在会改变范围或目标 change 身份的互斥选择时,才按 `comet/reference/decision-point.md` 提出一个联合问题;命名偏好本身不是独立阻塞点
123
+ - 只有仍存在会改变范围或目标 change 身份的互斥选择时,才按 `comet-classic/reference/decision-point.md` 提出一个联合问题;命名偏好本身不是独立阻塞点
123
124
 
124
125
  OpenSpec change 名称必须是 kebab-case 英文(小写字母、数字、单连字符)。若名称冲突但目标仍明确,派生一个不冲突且语义稳定的名称并继续;只有无法判断应复用现有 change 还是创建新 change 时才交给用户选择。
125
126
 
@@ -222,7 +223,7 @@ comet state check <name> open
222
223
 
223
224
  ### 5. 用户审视确认(阻塞点)
224
225
 
225
- 全部 OpenSpec artifacts 完成且内容完整性检查通过后,**必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户确认**。不得在用户确认前执行阶段守卫或自动流转。
226
+ 全部 OpenSpec artifacts 完成且内容完整性检查通过后,**必须按 `comet-classic/reference/decision-point.md` 的协议暂停并等待用户确认**。不得在用户确认前执行阶段守卫或自动流转。
226
227
 
227
228
  最终审视同时确认 change 名称、范围和产物内容;不得因 Step 1b 已完成解析而省略,也不得在此之前再增加一次常规摘要/命名确认。
228
229
 
@@ -257,7 +258,7 @@ comet guard <change-name> open --apply
257
258
 
258
259
  ## 自动衔接下一阶段
259
260
 
260
- 按 `comet/reference/auto-transition.md` 执行。关键命令:
261
+ 按 `comet-classic/reference/auto-transition.md` 执行。关键命令:
261
262
 
262
263
  ```bash
263
264
  comet state next <change-name>
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Comet Classic 阶段 1:Open"
3
+ short_description: "开启 OpenSpec change 并建立其产物"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: comet-tweak
3
- description: "仅在用户明确调用 /comet-tweak,或由 Comet 根 Skill/runtime 路由到 tweak preset 时使用;处理可收敛为单一 OpenSpec change 的轻量或中等变更。"
3
+ description: "Comet 预设 —— 处理可收敛为单一 OpenSpec change 的轻量或中等变更。"
4
+ disable-model-invocation: true
4
5
  ---
5
6
 
6
7
  # Comet 预设路径:Tweak
7
8
 
8
- 开始或恢复前必须先读取并执行 `comet/reference/classic-layout.md`;本文件中的 OpenSpec CLI 调用必须使用 adapter,文件路径必须使用该协议绑定的 `<classic-*>` 逻辑根。
9
+ 开始或恢复前必须先读取并执行 `comet-classic/reference/classic-layout.md`;本文件中的 OpenSpec CLI 调用必须使用 adapter,文件路径必须使用该协议绑定的 `<classic-*>` 逻辑根。
9
10
 
10
11
  Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程。它串联 OpenSpec 的核心流程,复用 open、build、verify、archive 能力,仅跳过 Superpowers brainstorming 和完整 plan。
11
12
 
@@ -29,7 +30,7 @@ Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程
29
30
 
30
31
  执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。
31
32
 
32
- 开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
33
+ 开始前按 `comet-classic/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet-classic/reference/context-recovery.md` 检查 phase/workflow。
33
34
 
34
35
  恢复已有 tweak change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
35
36
 
@@ -61,9 +62,9 @@ comet state select <name>
61
62
  comet state check <name> open
62
63
  ```
63
64
 
64
- 若上述 `select` / `check` 输出 `BLOCKED`,且原因是 `bound_branch` 与当前分支不一致,立即按 `comet/reference/decision-point.md` 暂停,让用户单选:切回绑定分支后重新运行入口验证,或在用户明确确认当前分支应接管该 change 后运行 `comet state rebind <change-name>` 并重新入口验证。不得自行切换分支,不得自行换绑。
65
+ 若上述 `select` / `check` 输出 `BLOCKED`,且原因是 `bound_branch` 与当前分支不一致,立即按 `comet-classic/reference/decision-point.md` 暂停,让用户单选:切回绑定分支后重新运行入口验证,或在用户明确确认当前分支应接管该 change 后运行 `comet state rebind <change-name>` 并重新入口验证。不得自行切换分支,不得自行换绑。
65
66
 
66
- 入口工作区隔离是用户决策点,不再把 `current` 当作默认隔离模式写入。按 `comet/reference/decision-point.md` 暂停让用户单选:
67
+ 入口工作区隔离是用户决策点,不再把 `current` 当作默认隔离模式写入。按 `comet-classic/reference/decision-point.md` 暂停让用户单选:
67
68
 
68
69
  - A. 当前分支直接工作:运行 `comet state set <name> isolation current`,如实绑定当前分支
69
70
  - B. 创建分支:先创建并切换到 `tweak/YYYYMMDD/<change-name>`,再运行 `comet state set <name> isolation branch`
@@ -89,7 +90,7 @@ comet guard <change-name> open --apply
89
90
  这条 apply 路径只属于 tweak。完整 `/comet-classic` 或 `workflow: full` 不得套用 tweak 的 `openspec-apply-change` 构建路径;full 仍必须先通过 `/comet-design` 生成 Design Doc,再由 `/comet-build` 通过 Superpowers `writing-plans`、执行方式选择和对应执行技能完成构建。
90
91
  </IMPORTANT>
91
92
 
92
- 继续或开始修改前,按 `comet/reference/dirty-worktree.md` 协议处理未提交改动。若归因后发现命中质变信号或文件数 tripwire,按本文件「升级判定」处理。
93
+ 继续或开始修改前,按 `comet-classic/reference/dirty-worktree.md` 协议处理未提交改动。若归因后发现命中质变信号或文件数 tripwire,按本文件「升级判定」处理。
93
94
 
94
95
  **立即执行:** 使用 Skill 工具加载 `openspec-apply-change` 技能。禁止跳过此步骤。
95
96
 
@@ -112,9 +113,9 @@ comet guard <change-name> open --apply
112
113
 
113
114
  执行 tweak 期间,只要运行程序、测试、构建或手动验证时出现崩溃、异常行为、测试失败或构建失败,必须使用 Skill 工具加载 Superpowers `systematic-debugging` 技能。在完成根因调查前,不得提出或实施源码修复。
114
115
 
115
- 具体调查、最小失败测试、修复验证和保持当前 change 验证闭环的要求,按 `comet/reference/debug-gate.md` 执行。
116
+ 具体调查、最小失败测试、修复验证和保持当前 change 验证闭环的要求,按 `comet-classic/reference/debug-gate.md` 执行。
116
117
 
117
- **升级判定检查**:build 全程持续判断,并在 build→verify 守卫执行前做一次集中复核。判定采用三层分工(详见「升级判定」章节):质变信号靠 agent 语义识别、文件数仅作提示交用户拍板、scale 脚本仅管验证轻重。命中质变信号或文件数超提示阈值时,**不得自行升级或自行判定可继续**,必须按 `comet/reference/decision-point.md` 暂停并把决策权交给用户:继续 tweak 轻量流程,还是升级为完整 `/comet-classic`。
118
+ **升级判定检查**:build 全程持续判断,并在 build→verify 守卫执行前做一次集中复核。判定采用三层分工(详见「升级判定」章节):质变信号靠 agent 语义识别、文件数仅作提示交用户拍板、scale 脚本仅管验证轻重。命中质变信号或文件数超提示阈值时,**不得自行升级或自行判定可继续**,必须按 `comet-classic/reference/decision-point.md` 暂停并把决策权交给用户:继续 tweak 轻量流程,还是升级为完整 `/comet-classic`。
118
119
 
119
120
  运行阶段守卫完成 build → verify 过渡:
120
121
 
@@ -174,7 +175,7 @@ tweak 的升级判定只决定是否从轻量预设转为 full;delta spec 本
174
175
 
175
176
  文件数 tripwire 仅作提示:改动文件数超过提示阈值(如 > 6 个文件)时,也交给用户决定继续 tweak 还是升级 full;文件数多不等于质变。tweak 常伴随 delta spec 或配置调整,波及面天然比 bug 修复宽,故提示阈值高于 hotfix。
176
177
 
177
- 命中质变信号或文件数 tripwire 时,**必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户明确选择**。不得直接进入 `/comet-design`,不得自动补充 Design Doc。
178
+ 命中质变信号或文件数 tripwire 时,**必须按 `comet-classic/reference/decision-point.md` 的协议暂停并等待用户明确选择**。不得直接进入 `/comet-design`,不得自动补充 Design Doc。
178
179
 
179
180
  用户选择升级(选项 B)后,使用状态机合法的升级通道,单条命令完成预设流程 → full 转换并回退到 design 阶段:
180
181
 
@@ -197,7 +198,7 @@ comet state transition <name> preset-escalate
197
198
 
198
199
  ## 自动衔接下一阶段
199
200
 
200
- 按 `comet/reference/auto-transition.md` 执行。关键命令:
201
+ 按 `comet-classic/reference/auto-transition.md` 执行。关键命令:
201
202
 
202
203
  ```bash
203
204
  comet state next <name>