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