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

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 (761) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +85 -56
  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 +26 -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 +128 -128
  13. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +77 -77
  14. package/assets/skills/comet/scripts/comet-guard.mjs +144 -144
  15. package/assets/skills/comet/scripts/comet-handoff.mjs +107 -107
  16. package/assets/skills/comet/scripts/comet-hook-guard.mjs +128 -128
  17. package/assets/skills/comet/scripts/comet-hook-router.mjs +143 -141
  18. package/assets/skills/comet/scripts/comet-resume-probe.mjs +100 -100
  19. package/assets/skills/comet/scripts/comet-runtime.mjs +194 -193
  20. package/assets/skills/comet/scripts/comet-state.mjs +118 -118
  21. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +95 -95
  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 +28 -68
  27. package/assets/skills/comet-build/agents/openai.yaml +5 -0
  28. package/assets/skills/comet-classic/SKILL.md +28 -22
  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 +3 -3
  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 +4 -2
  39. package/assets/skills/{comet → comet-classic}/reference/subagent-dispatch.md +1 -1
  40. package/assets/skills/comet-classic/reference/workspace.md +23 -0
  41. package/assets/skills/comet-design/SKILL.md +7 -6
  42. package/assets/skills/comet-design/agents/openai.yaml +5 -0
  43. package/assets/skills/comet-hotfix/SKILL.md +10 -9
  44. package/assets/skills/comet-hotfix/agents/openai.yaml +5 -0
  45. package/assets/skills/comet-native/SKILL.md +60 -171
  46. package/assets/skills/comet-native/agents/openai.yaml +3 -0
  47. package/assets/skills/comet-native/reference/artifacts.md +24 -89
  48. package/assets/skills/comet-native/reference/clarification.md +54 -29
  49. package/assets/skills/comet-native/reference/commands.md +30 -173
  50. package/assets/skills/comet-native/reference/recovery.md +38 -88
  51. package/assets/skills/comet-native/reference/workspace.md +23 -0
  52. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +184 -152
  53. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +214 -158
  54. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +132 -123
  55. package/assets/skills/comet-native/scripts/comet-native-init.mjs +134 -124
  56. package/assets/skills/comet-native/scripts/comet-native-new.mjs +165 -158
  57. package/assets/skills/comet-native/scripts/comet-native-next.mjs +183 -152
  58. package/assets/skills/comet-native/scripts/comet-native-root.mjs +152 -147
  59. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +247 -202
  60. package/assets/skills/comet-native/scripts/comet-native-select.mjs +150 -143
  61. package/assets/skills/comet-native/scripts/comet-native-show.mjs +128 -121
  62. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +133 -151
  63. package/assets/skills/comet-native/scripts/comet-native-status.mjs +147 -140
  64. package/assets/skills/comet-open/SKILL.md +31 -11
  65. package/assets/skills/comet-open/agents/openai.yaml +5 -0
  66. package/assets/skills/comet-tweak/SKILL.md +11 -10
  67. package/assets/skills/comet-tweak/agents/openai.yaml +5 -0
  68. package/assets/skills/comet-verify/SKILL.md +9 -8
  69. package/assets/skills/comet-verify/agents/openai.yaml +5 -0
  70. package/assets/skills-zh/comet/SKILL.md +1 -1
  71. package/assets/skills-zh/comet/agents/openai.yaml +3 -0
  72. package/assets/skills-zh/comet-any/SKILL.md +2 -1
  73. package/assets/skills-zh/comet-any/agents/openai.yaml +5 -0
  74. package/assets/skills-zh/comet-archive/SKILL.md +7 -6
  75. package/assets/skills-zh/comet-archive/agents/openai.yaml +5 -0
  76. package/assets/skills-zh/comet-build/SKILL.md +28 -68
  77. package/assets/skills-zh/comet-build/agents/openai.yaml +5 -0
  78. package/assets/skills-zh/comet-classic/SKILL.md +29 -23
  79. package/assets/skills-zh/comet-classic/agents/openai.yaml +3 -0
  80. package/assets/skills-zh/{comet → comet-classic}/reference/auto-transition.md +1 -1
  81. package/assets/skills-zh/{comet → comet-classic}/reference/comet-yaml-fields.md +3 -3
  82. package/assets/skills-zh/{comet → comet-classic}/reference/context-recovery.md +5 -5
  83. package/assets/skills-zh/{comet → comet-classic}/reference/debug-gate.md +2 -2
  84. package/assets/skills-zh/{comet → comet-classic}/reference/decision-point.md +1 -1
  85. package/assets/skills-zh/{comet → comet-classic}/reference/dirty-worktree.md +1 -1
  86. package/assets/skills-zh/{comet → comet-classic}/reference/file-structure.md +1 -1
  87. package/assets/skills-zh/{comet → comet-classic}/reference/intent-frame.md +1 -1
  88. package/assets/skills-zh/{comet → comet-classic}/reference/scripts.md +4 -2
  89. package/assets/skills-zh/{comet → comet-classic}/reference/subagent-dispatch.md +1 -1
  90. package/assets/skills-zh/comet-classic/reference/workspace.md +23 -0
  91. package/assets/skills-zh/comet-design/SKILL.md +7 -6
  92. package/assets/skills-zh/comet-design/agents/openai.yaml +5 -0
  93. package/assets/skills-zh/comet-hotfix/SKILL.md +10 -9
  94. package/assets/skills-zh/comet-hotfix/agents/openai.yaml +5 -0
  95. package/assets/skills-zh/comet-native/SKILL.md +60 -171
  96. package/assets/skills-zh/comet-native/agents/openai.yaml +3 -0
  97. package/assets/skills-zh/comet-native/reference/artifacts.md +24 -89
  98. package/assets/skills-zh/comet-native/reference/clarification.md +40 -15
  99. package/assets/skills-zh/comet-native/reference/commands.md +30 -173
  100. package/assets/skills-zh/comet-native/reference/recovery.md +36 -86
  101. package/assets/skills-zh/comet-native/reference/workspace.md +23 -0
  102. package/assets/skills-zh/comet-open/SKILL.md +31 -11
  103. package/assets/skills-zh/comet-open/agents/openai.yaml +5 -0
  104. package/assets/skills-zh/comet-tweak/SKILL.md +11 -10
  105. package/assets/skills-zh/comet-tweak/agents/openai.yaml +5 -0
  106. package/assets/skills-zh/comet-verify/SKILL.md +9 -8
  107. package/assets/skills-zh/comet-verify/agents/openai.yaml +5 -0
  108. package/bin/fast-runtime-router.js +0 -4
  109. package/dist/app/cli/index.js +20 -1
  110. package/dist/app/cli/index.js.map +1 -1
  111. package/dist/app/commands/classic.d.ts.map +1 -1
  112. package/dist/app/commands/classic.js +2 -0
  113. package/dist/app/commands/classic.js.map +1 -1
  114. package/dist/app/commands/doctor.d.ts.map +1 -1
  115. package/dist/app/commands/doctor.js +8 -0
  116. package/dist/app/commands/doctor.js.map +1 -1
  117. package/dist/app/commands/eval.d.ts +9 -2
  118. package/dist/app/commands/eval.d.ts.map +1 -1
  119. package/dist/app/commands/eval.js +293 -48
  120. package/dist/app/commands/eval.js.map +1 -1
  121. package/dist/app/commands/init.d.ts.map +1 -1
  122. package/dist/app/commands/init.js +11 -2
  123. package/dist/app/commands/init.js.map +1 -1
  124. package/dist/app/commands/update.d.ts.map +1 -1
  125. package/dist/app/commands/update.js +13 -3
  126. package/dist/app/commands/update.js.map +1 -1
  127. package/dist/config/repository-layout.json +0 -8
  128. package/dist/domains/bundle/bundle-platform.d.ts.map +1 -1
  129. package/dist/domains/bundle/bundle-platform.js +8 -0
  130. package/dist/domains/bundle/bundle-platform.js.map +1 -1
  131. package/dist/domains/bundle/types.d.ts +1 -1
  132. package/dist/domains/bundle/types.d.ts.map +1 -1
  133. package/dist/domains/comet-classic/classic-cli.d.ts +1 -1
  134. package/dist/domains/comet-classic/classic-cli.d.ts.map +1 -1
  135. package/dist/domains/comet-classic/classic-cli.js +3 -0
  136. package/dist/domains/comet-classic/classic-cli.js.map +1 -1
  137. package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
  138. package/dist/domains/comet-classic/classic-current-change.js +29 -3
  139. package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
  140. package/dist/domains/comet-classic/classic-guard.js +2 -2
  141. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  142. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  143. package/dist/domains/comet-classic/classic-hook-guard.js +14 -1
  144. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  145. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  146. package/dist/domains/comet-classic/classic-state-command.js +31 -8
  147. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  148. package/dist/domains/comet-classic/classic-workspace-command.d.ts +3 -0
  149. package/dist/domains/comet-classic/classic-workspace-command.d.ts.map +1 -0
  150. package/dist/domains/comet-classic/classic-workspace-command.js +45 -0
  151. package/dist/domains/comet-classic/classic-workspace-command.js.map +1 -0
  152. package/dist/domains/comet-classic/classic-workspace.d.ts +38 -0
  153. package/dist/domains/comet-classic/classic-workspace.d.ts.map +1 -0
  154. package/dist/domains/comet-classic/classic-workspace.js +315 -0
  155. package/dist/domains/comet-classic/classic-workspace.js.map +1 -0
  156. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  157. package/dist/domains/comet-entry/hook-adapter.js +3 -0
  158. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  159. package/dist/domains/comet-entry/hook-router-entry.d.ts +2 -0
  160. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  161. package/dist/domains/comet-entry/hook-router-entry.js +32 -3
  162. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  163. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  164. package/dist/domains/comet-entry/init-workflow.js +13 -5
  165. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  166. package/dist/domains/comet-entry/project-activation.d.ts.map +1 -1
  167. package/dist/domains/comet-entry/project-activation.js +2 -1
  168. package/dist/domains/comet-entry/project-activation.js.map +1 -1
  169. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  170. package/dist/domains/comet-entry/resume-probe.js +48 -4
  171. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  172. package/dist/domains/comet-native/index.d.ts +1 -0
  173. package/dist/domains/comet-native/index.d.ts.map +1 -1
  174. package/dist/domains/comet-native/index.js +1 -0
  175. package/dist/domains/comet-native/index.js.map +1 -1
  176. package/dist/domains/comet-native/native-acceptance.d.ts +4 -3
  177. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  178. package/dist/domains/comet-native/native-acceptance.js +23 -18
  179. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  180. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -1
  181. package/dist/domains/comet-native/native-archive-command.js +204 -61
  182. package/dist/domains/comet-native/native-archive-command.js.map +1 -1
  183. package/dist/domains/comet-native/native-archive-transaction.d.ts.map +1 -1
  184. package/dist/domains/comet-native/native-archive-transaction.js +28 -23
  185. package/dist/domains/comet-native/native-archive-transaction.js.map +1 -1
  186. package/dist/domains/comet-native/native-archive.d.ts +1 -0
  187. package/dist/domains/comet-native/native-archive.d.ts.map +1 -1
  188. package/dist/domains/comet-native/native-archive.js +56 -12
  189. package/dist/domains/comet-native/native-archive.js.map +1 -1
  190. package/dist/domains/comet-native/native-bounded-file.d.ts +32 -2
  191. package/dist/domains/comet-native/native-bounded-file.d.ts.map +1 -1
  192. package/dist/domains/comet-native/native-bounded-file.js +87 -6
  193. package/dist/domains/comet-native/native-bounded-file.js.map +1 -1
  194. package/dist/domains/comet-native/native-build-evidence.d.ts.map +1 -1
  195. package/dist/domains/comet-native/native-build-evidence.js +23 -1
  196. package/dist/domains/comet-native/native-build-evidence.js.map +1 -1
  197. package/dist/domains/comet-native/native-change.d.ts +1 -0
  198. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  199. package/dist/domains/comet-native/native-change.js +96 -8
  200. package/dist/domains/comet-native/native-change.js.map +1 -1
  201. package/dist/domains/comet-native/native-check-executor.d.ts +36 -0
  202. package/dist/domains/comet-native/native-check-executor.d.ts.map +1 -0
  203. package/dist/domains/comet-native/native-check-executor.js +132 -0
  204. package/dist/domains/comet-native/native-check-executor.js.map +1 -0
  205. package/dist/domains/comet-native/native-check-receipt-model.d.ts +9 -0
  206. package/dist/domains/comet-native/native-check-receipt-model.d.ts.map +1 -1
  207. package/dist/domains/comet-native/native-check-receipt-model.js +70 -8
  208. package/dist/domains/comet-native/native-check-receipt-model.js.map +1 -1
  209. package/dist/domains/comet-native/native-check-receipt-storage.d.ts.map +1 -1
  210. package/dist/domains/comet-native/native-check-receipt-storage.js +9 -8
  211. package/dist/domains/comet-native/native-check-receipt-storage.js.map +1 -1
  212. package/dist/domains/comet-native/native-check-receipt.d.ts.map +1 -1
  213. package/dist/domains/comet-native/native-check-receipt.js +123 -60
  214. package/dist/domains/comet-native/native-check-receipt.js.map +1 -1
  215. package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -1
  216. package/dist/domains/comet-native/native-checkpoint-command.js +0 -6
  217. package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -1
  218. package/dist/domains/comet-native/native-checkpoint-storage.d.ts.map +1 -1
  219. package/dist/domains/comet-native/native-checkpoint-storage.js +27 -19
  220. package/dist/domains/comet-native/native-checkpoint-storage.js.map +1 -1
  221. package/dist/domains/comet-native/native-children.d.ts +49 -0
  222. package/dist/domains/comet-native/native-children.d.ts.map +1 -0
  223. package/dist/domains/comet-native/native-children.js +388 -0
  224. package/dist/domains/comet-native/native-children.js.map +1 -0
  225. package/dist/domains/comet-native/native-cli-help.d.ts +6 -0
  226. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -0
  227. package/dist/domains/comet-native/native-cli-help.js +192 -0
  228. package/dist/domains/comet-native/native-cli-help.js.map +1 -0
  229. package/dist/domains/comet-native/native-cli-shared.d.ts +2 -2
  230. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -1
  231. package/dist/domains/comet-native/native-cli-shared.js +46 -24
  232. package/dist/domains/comet-native/native-cli-shared.js.map +1 -1
  233. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  234. package/dist/domains/comet-native/native-cli.js +18 -11
  235. package/dist/domains/comet-native/native-cli.js.map +1 -1
  236. package/dist/domains/comet-native/native-config.d.ts +2 -1
  237. package/dist/domains/comet-native/native-config.d.ts.map +1 -1
  238. package/dist/domains/comet-native/native-config.js +2 -1
  239. package/dist/domains/comet-native/native-config.js.map +1 -1
  240. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  241. package/dist/domains/comet-native/native-continuation.js +175 -147
  242. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  243. package/dist/domains/comet-native/native-diagnostics.d.ts.map +1 -1
  244. package/dist/domains/comet-native/native-diagnostics.js +96 -13
  245. package/dist/domains/comet-native/native-diagnostics.js.map +1 -1
  246. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -1
  247. package/dist/domains/comet-native/native-doctor-command.js +332 -0
  248. package/dist/domains/comet-native/native-doctor-command.js.map +1 -1
  249. package/dist/domains/comet-native/native-doctor.d.ts +1 -0
  250. package/dist/domains/comet-native/native-doctor.d.ts.map +1 -1
  251. package/dist/domains/comet-native/native-doctor.js +116 -22
  252. package/dist/domains/comet-native/native-doctor.js.map +1 -1
  253. package/dist/domains/comet-native/native-evidence-projection.d.ts +50 -0
  254. package/dist/domains/comet-native/native-evidence-projection.d.ts.map +1 -0
  255. package/dist/domains/comet-native/native-evidence-projection.js +284 -0
  256. package/dist/domains/comet-native/native-evidence-projection.js.map +1 -0
  257. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  258. package/dist/domains/comet-native/native-evidence-retention.js +14 -12
  259. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  260. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  261. package/dist/domains/comet-native/native-evidence-storage.js +14 -11
  262. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  263. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  264. package/dist/domains/comet-native/native-findings.js +18 -0
  265. package/dist/domains/comet-native/native-findings.js.map +1 -1
  266. package/dist/domains/comet-native/native-git-provenance.d.ts +16 -0
  267. package/dist/domains/comet-native/native-git-provenance.d.ts.map +1 -0
  268. package/dist/domains/comet-native/native-git-provenance.js +171 -0
  269. package/dist/domains/comet-native/native-git-provenance.js.map +1 -0
  270. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  271. package/dist/domains/comet-native/native-hook-guard.js +199 -19
  272. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  273. package/dist/domains/comet-native/native-init-command.d.ts.map +1 -1
  274. package/dist/domains/comet-native/native-init-command.js +14 -2
  275. package/dist/domains/comet-native/native-init-command.js.map +1 -1
  276. package/dist/domains/comet-native/native-local-execution.d.ts +25 -0
  277. package/dist/domains/comet-native/native-local-execution.d.ts.map +1 -0
  278. package/dist/domains/comet-native/native-local-execution.js +241 -0
  279. package/dist/domains/comet-native/native-local-execution.js.map +1 -0
  280. package/dist/domains/comet-native/native-lock.d.ts +1 -1
  281. package/dist/domains/comet-native/native-lock.d.ts.map +1 -1
  282. package/dist/domains/comet-native/native-lock.js +9 -9
  283. package/dist/domains/comet-native/native-lock.js.map +1 -1
  284. package/dist/domains/comet-native/native-loop-runtime.d.ts +63 -0
  285. package/dist/domains/comet-native/native-loop-runtime.d.ts.map +1 -0
  286. package/dist/domains/comet-native/native-loop-runtime.js +580 -0
  287. package/dist/domains/comet-native/native-loop-runtime.js.map +1 -0
  288. package/dist/domains/comet-native/native-mutation-lock.d.ts +2 -0
  289. package/dist/domains/comet-native/native-mutation-lock.d.ts.map +1 -1
  290. package/dist/domains/comet-native/native-mutation-lock.js +23 -2
  291. package/dist/domains/comet-native/native-mutation-lock.js.map +1 -1
  292. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -1
  293. package/dist/domains/comet-native/native-new-command.js +27 -20
  294. package/dist/domains/comet-native/native-new-command.js.map +1 -1
  295. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -1
  296. package/dist/domains/comet-native/native-next-command.js +193 -62
  297. package/dist/domains/comet-native/native-next-command.js.map +1 -1
  298. package/dist/domains/comet-native/native-paths.d.ts +18 -0
  299. package/dist/domains/comet-native/native-paths.d.ts.map +1 -1
  300. package/dist/domains/comet-native/native-paths.js +125 -13
  301. package/dist/domains/comet-native/native-paths.js.map +1 -1
  302. package/dist/domains/comet-native/native-portable-acceptance.d.ts +28 -0
  303. package/dist/domains/comet-native/native-portable-acceptance.d.ts.map +1 -0
  304. package/dist/domains/comet-native/native-portable-acceptance.js +73 -0
  305. package/dist/domains/comet-native/native-portable-acceptance.js.map +1 -0
  306. package/dist/domains/comet-native/native-portable-archive.d.ts +37 -0
  307. package/dist/domains/comet-native/native-portable-archive.d.ts.map +1 -0
  308. package/dist/domains/comet-native/native-portable-archive.js +492 -0
  309. package/dist/domains/comet-native/native-portable-archive.js.map +1 -0
  310. package/dist/domains/comet-native/native-portable-continuation.d.ts +30 -0
  311. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -0
  312. package/dist/domains/comet-native/native-portable-continuation.js +403 -0
  313. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -0
  314. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts +9 -0
  315. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts.map +1 -0
  316. package/dist/domains/comet-native/native-portable-migration-runtime.js +213 -0
  317. package/dist/domains/comet-native/native-portable-migration-runtime.js.map +1 -0
  318. package/dist/domains/comet-native/native-portable-migration.d.ts +42 -0
  319. package/dist/domains/comet-native/native-portable-migration.d.ts.map +1 -0
  320. package/dist/domains/comet-native/native-portable-migration.js +212 -0
  321. package/dist/domains/comet-native/native-portable-migration.js.map +1 -0
  322. package/dist/domains/comet-native/native-portable-recovery.d.ts +15 -0
  323. package/dist/domains/comet-native/native-portable-recovery.d.ts.map +1 -0
  324. package/dist/domains/comet-native/native-portable-recovery.js +203 -0
  325. package/dist/domains/comet-native/native-portable-recovery.js.map +1 -0
  326. package/dist/domains/comet-native/native-portable-runtime.d.ts +155 -0
  327. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -0
  328. package/dist/domains/comet-native/native-portable-runtime.js +1550 -0
  329. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -0
  330. package/dist/domains/comet-native/native-portable-state.d.ts +30 -0
  331. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -0
  332. package/dist/domains/comet-native/native-portable-state.js +701 -0
  333. package/dist/domains/comet-native/native-portable-state.js.map +1 -0
  334. package/dist/domains/comet-native/native-portable-status.d.ts +65 -0
  335. package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -0
  336. package/dist/domains/comet-native/native-portable-status.js +133 -0
  337. package/dist/domains/comet-native/native-portable-status.js.map +1 -0
  338. package/dist/domains/comet-native/native-portable-text.d.ts +8 -0
  339. package/dist/domains/comet-native/native-portable-text.d.ts.map +1 -0
  340. package/dist/domains/comet-native/native-portable-text.js +28 -0
  341. package/dist/domains/comet-native/native-portable-text.js.map +1 -0
  342. package/dist/domains/comet-native/native-portable-transactions.d.ts +41 -0
  343. package/dist/domains/comet-native/native-portable-transactions.d.ts.map +1 -0
  344. package/dist/domains/comet-native/native-portable-transactions.js +204 -0
  345. package/dist/domains/comet-native/native-portable-transactions.js.map +1 -0
  346. package/dist/domains/comet-native/native-portable-types.d.ts +166 -0
  347. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -0
  348. package/dist/domains/comet-native/native-portable-types.js +18 -0
  349. package/dist/domains/comet-native/native-portable-types.js.map +1 -0
  350. package/dist/domains/comet-native/native-repair-integration.js +5 -5
  351. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  352. package/dist/domains/comet-native/native-resume-view.d.ts.map +1 -1
  353. package/dist/domains/comet-native/native-resume-view.js +1 -5
  354. package/dist/domains/comet-native/native-resume-view.js.map +1 -1
  355. package/dist/domains/comet-native/native-root-move.d.ts.map +1 -1
  356. package/dist/domains/comet-native/native-root-move.js +4 -20
  357. package/dist/domains/comet-native/native-root-move.js.map +1 -1
  358. package/dist/domains/comet-native/native-run-consistency.d.ts.map +1 -1
  359. package/dist/domains/comet-native/native-run-consistency.js +8 -12
  360. package/dist/domains/comet-native/native-run-consistency.js.map +1 -1
  361. package/dist/domains/comet-native/native-run-store.js +4 -4
  362. package/dist/domains/comet-native/native-run-store.js.map +1 -1
  363. package/dist/domains/comet-native/native-runner-input.d.ts +160 -0
  364. package/dist/domains/comet-native/native-runner-input.d.ts.map +1 -0
  365. package/dist/domains/comet-native/native-runner-input.js +347 -0
  366. package/dist/domains/comet-native/native-runner-input.js.map +1 -0
  367. package/dist/domains/comet-native/native-runner-protocol.d.ts +40 -0
  368. package/dist/domains/comet-native/native-runner-protocol.d.ts.map +1 -0
  369. package/dist/domains/comet-native/native-runner-protocol.js +55 -0
  370. package/dist/domains/comet-native/native-runner-protocol.js.map +1 -0
  371. package/dist/domains/comet-native/native-runtime-package.d.ts +3 -0
  372. package/dist/domains/comet-native/native-runtime-package.d.ts.map +1 -1
  373. package/dist/domains/comet-native/native-runtime-package.js +5 -1
  374. package/dist/domains/comet-native/native-runtime-package.js.map +1 -1
  375. package/dist/domains/comet-native/native-schema-migration.d.ts.map +1 -1
  376. package/dist/domains/comet-native/native-schema-migration.js +30 -27
  377. package/dist/domains/comet-native/native-schema-migration.js.map +1 -1
  378. package/dist/domains/comet-native/native-select-command.d.ts.map +1 -1
  379. package/dist/domains/comet-native/native-select-command.js +8 -4
  380. package/dist/domains/comet-native/native-select-command.js.map +1 -1
  381. package/dist/domains/comet-native/native-selection.d.ts.map +1 -1
  382. package/dist/domains/comet-native/native-selection.js +11 -2
  383. package/dist/domains/comet-native/native-selection.js.map +1 -1
  384. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -1
  385. package/dist/domains/comet-native/native-show-command.js +37 -0
  386. package/dist/domains/comet-native/native-show-command.js.map +1 -1
  387. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  388. package/dist/domains/comet-native/native-snapshot.js +13 -10
  389. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  390. package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -1
  391. package/dist/domains/comet-native/native-spec-command.js +14 -28
  392. package/dist/domains/comet-native/native-spec-command.js.map +1 -1
  393. package/dist/domains/comet-native/native-specs.js +3 -3
  394. package/dist/domains/comet-native/native-specs.js.map +1 -1
  395. package/dist/domains/comet-native/native-status-command.d.ts.map +1 -1
  396. package/dist/domains/comet-native/native-status-command.js +7 -17
  397. package/dist/domains/comet-native/native-status-command.js.map +1 -1
  398. package/dist/domains/comet-native/native-status-discovery.d.ts +51 -0
  399. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -0
  400. package/dist/domains/comet-native/native-status-discovery.js +299 -0
  401. package/dist/domains/comet-native/native-status-discovery.js.map +1 -0
  402. package/dist/domains/comet-native/native-trajectory-recovery.d.ts.map +1 -1
  403. package/dist/domains/comet-native/native-trajectory-recovery.js +6 -9
  404. package/dist/domains/comet-native/native-trajectory-recovery.js.map +1 -1
  405. package/dist/domains/comet-native/native-transaction.d.ts.map +1 -1
  406. package/dist/domains/comet-native/native-transaction.js +31 -20
  407. package/dist/domains/comet-native/native-transaction.js.map +1 -1
  408. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  409. package/dist/domains/comet-native/native-transition-evidence.js +1 -0
  410. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  411. package/dist/domains/comet-native/native-transition-journal.d.ts.map +1 -1
  412. package/dist/domains/comet-native/native-transition-journal.js +71 -22
  413. package/dist/domains/comet-native/native-transition-journal.js.map +1 -1
  414. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  415. package/dist/domains/comet-native/native-transitions.js +167 -15
  416. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  417. package/dist/domains/comet-native/native-types.d.ts +36 -1
  418. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  419. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  420. package/dist/domains/comet-native/native-verification-receipt-runtime.js +18 -100
  421. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  422. package/dist/domains/comet-native/native-verification-report-v2.d.ts +12 -0
  423. package/dist/domains/comet-native/native-verification-report-v2.d.ts.map +1 -0
  424. package/dist/domains/comet-native/native-verification-report-v2.js +141 -0
  425. package/dist/domains/comet-native/native-verification-report-v2.js.map +1 -0
  426. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  427. package/dist/domains/comet-native/native-verification-runtime.js +7 -2
  428. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  429. package/dist/domains/comet-native/native-verification-scope.d.ts +23 -0
  430. package/dist/domains/comet-native/native-verification-scope.d.ts.map +1 -1
  431. package/dist/domains/comet-native/native-verification-scope.js +106 -19
  432. package/dist/domains/comet-native/native-verification-scope.js.map +1 -1
  433. package/dist/domains/comet-native/native-verifier-protocol.d.ts +49 -0
  434. package/dist/domains/comet-native/native-verifier-protocol.d.ts.map +1 -0
  435. package/dist/domains/comet-native/native-verifier-protocol.js +157 -0
  436. package/dist/domains/comet-native/native-verifier-protocol.js.map +1 -0
  437. package/dist/domains/comet-native/native-workspace-finish.d.ts +61 -0
  438. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -0
  439. package/dist/domains/comet-native/native-workspace-finish.js +332 -0
  440. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -0
  441. package/dist/domains/comet-native/native-workspace-preparation.d.ts +32 -0
  442. package/dist/domains/comet-native/native-workspace-preparation.d.ts.map +1 -0
  443. package/dist/domains/comet-native/native-workspace-preparation.js +324 -0
  444. package/dist/domains/comet-native/native-workspace-preparation.js.map +1 -0
  445. package/dist/domains/comet-native/native-workspace.d.ts +9 -1
  446. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  447. package/dist/domains/comet-native/native-workspace.js +109 -11
  448. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  449. package/dist/domains/dashboard/collector.d.ts +1 -1
  450. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  451. package/dist/domains/dashboard/collector.js +102 -87
  452. package/dist/domains/dashboard/collector.js.map +1 -1
  453. package/dist/domains/dashboard/native-adapter.d.ts +155 -126
  454. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  455. package/dist/domains/dashboard/native-adapter.js +165 -268
  456. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  457. package/dist/domains/dashboard/native-collector.d.ts +5 -4
  458. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  459. package/dist/domains/dashboard/native-collector.js +506 -439
  460. package/dist/domains/dashboard/native-collector.js.map +1 -1
  461. package/dist/domains/dashboard/native-legacy-adapter.d.ts +37 -0
  462. package/dist/domains/dashboard/native-legacy-adapter.d.ts.map +1 -0
  463. package/dist/domains/dashboard/native-legacy-adapter.js +127 -0
  464. package/dist/domains/dashboard/native-legacy-adapter.js.map +1 -0
  465. package/dist/domains/dashboard/server.d.ts.map +1 -1
  466. package/dist/domains/dashboard/server.js +5 -3
  467. package/dist/domains/dashboard/server.js.map +1 -1
  468. package/dist/domains/dashboard/types.d.ts +5 -0
  469. package/dist/domains/dashboard/types.d.ts.map +1 -1
  470. package/dist/domains/dashboard/web/assets/abnfDiagram-N423BO3Z-B5cFR6hS.js +1 -0
  471. package/dist/domains/dashboard/web/assets/arc-CVQDtMsu.js +1 -0
  472. package/dist/domains/dashboard/web/assets/architectureDiagram-T3A2C74G-C0v0kULK.js +36 -0
  473. package/dist/domains/dashboard/web/assets/blockDiagram-VBNYF7ZC-DpHLuxu4.js +132 -0
  474. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-Ca5zba3N.js → c4Diagram-5PPSVZJV-BHnFxUs1.js} +1 -1
  475. package/dist/domains/dashboard/web/assets/channel-eM0x3m1G.js +1 -0
  476. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-Bj6HWRwi.js → chunk-2GRJ4B5K-CGC9gh5n.js} +1 -1
  477. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-B1kXfg5N.js → chunk-2Q5K7J3B-l4puLU_O.js} +1 -1
  478. package/dist/domains/dashboard/web/assets/chunk-5RXB4S5H-ls9jQHZc.js +231 -0
  479. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BAJLB5V6.js → chunk-5VM5RSS4-BVavmTEq.js} +1 -1
  480. package/dist/domains/dashboard/web/assets/chunk-6Q2QTUOP-Dungt2g9.js +88 -0
  481. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-CwghIMO9.js → chunk-GF5L2VYU-BidXO_ZP.js} +5 -5
  482. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-JYluRsP-.js → chunk-JWPE2WC7-57L5Up5X.js} +1 -1
  483. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-CCVPBm0J.js → chunk-KBJHAD2P-C5u5vbwr.js} +1 -1
  484. package/dist/domains/dashboard/web/assets/chunk-RYQCIY6F-CvLz21I2.js +1 -0
  485. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DfYm7pN7.js → chunk-XXDRQBXY-D5nJpckG.js} +1 -1
  486. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-CEFhao2K.js +1 -0
  487. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-CEFhao2K.js +1 -0
  488. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-BBrkuiAU.js → cose-bilkent-JH36ORCC-Dp0JAGyE.js} +1 -1
  489. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-DlFhgQHt.js → cynefin-VYW2F7L2-EjC54l1g.js} +2 -2
  490. package/dist/domains/dashboard/web/assets/cynefinDiagram-MW4NZA55-CpYrW3w3.js +62 -0
  491. package/dist/domains/dashboard/web/assets/dagre-VZM6K2ZE-h5K39rCk.js +4 -0
  492. package/dist/domains/dashboard/web/assets/demo-BfLsKrIL.js +45 -0
  493. package/dist/domains/dashboard/web/assets/diagram-7IWD3JNH-CKQj9O4H.js +30 -0
  494. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-BQahyP-C.js → diagram-B4RE2ZJO-DXRIYcnW.js} +3 -3
  495. package/dist/domains/dashboard/web/assets/diagram-LBJQPF4R-wWutQYmv.js +24 -0
  496. package/dist/domains/dashboard/web/assets/diagram-Q27KOJAE-EgXLJQYi.js +24 -0
  497. package/dist/domains/dashboard/web/assets/diagram-UB23O5K3-CsQRXDQZ.js +41 -0
  498. package/dist/domains/dashboard/web/assets/ebnfDiagram-BXEA7PRR-gm328Eho.js +1 -0
  499. package/dist/domains/dashboard/web/assets/erDiagram-JOGREHBK-BbbMVUx_.js +85 -0
  500. package/dist/domains/dashboard/web/assets/flowDiagram-UKHOOZJN-1Y7scCns.js +156 -0
  501. package/dist/domains/dashboard/web/assets/ganttDiagram-PKOTCBZU-BAoBqczv.js +292 -0
  502. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-DCxvMAUJ.js → gitGraphDiagram-DS77QQ5N-CMUAyEzl.js} +3 -3
  503. package/dist/domains/dashboard/web/assets/{graph--OzhPTMs.js → graph-DOmOIIwC.js} +1 -1
  504. package/dist/domains/dashboard/web/assets/{index-Blit0P5Z.js → index-CCApJ0Yr.js} +1 -1
  505. package/dist/domains/dashboard/web/assets/index-DWdm_XBi.js +257 -0
  506. package/dist/domains/dashboard/web/assets/index-DhhbseFJ.css +1 -0
  507. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-9qXEkzDe.js → infoDiagram-6WML65LV-BaCdtYYC.js} +1 -1
  508. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkf5othW.js → ishikawaDiagram-WSZJBQD7-DQQlNnjU.js} +4 -4
  509. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C2_IkO4s.js → journeyDiagram-NVQOT4AX-DW9wUMqn.js} +1 -1
  510. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BxWgu4DL.js → kanban-definition-27J2QSJJ-C_ITaZ0q.js} +7 -7
  511. package/dist/domains/dashboard/web/assets/layout-D-LzfAck.js +1 -0
  512. package/dist/domains/dashboard/web/assets/{linear-Dkr6p-Ro.js → linear-DXOo6ZRT.js} +1 -1
  513. package/dist/domains/dashboard/web/assets/map-DxJ2ADlA.js +1 -0
  514. package/dist/domains/dashboard/web/assets/mermaid.core-ol-0NI97.js +306 -0
  515. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-C9xyxGfa.js → mindmap-definition-FAOFIHXS-CHF_HOLV.js} +1 -1
  516. package/dist/domains/dashboard/web/assets/pegDiagram-VL7TDLO6-wQEvkNF8.js +1 -0
  517. package/dist/domains/dashboard/web/assets/pieDiagram-7S7Q4E2Y-C3H3kiIP.js +39 -0
  518. package/dist/domains/dashboard/web/assets/purify.es-Cz4mVeUR.js +3 -0
  519. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-Cy6iOcxc.js → quadrantDiagram-CIZ2JOQS-S0FdVzJb.js} +4 -4
  520. package/dist/domains/dashboard/web/assets/railroadDiagram-AXF67PYL-DCDXDaVg.js +1 -0
  521. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-B_gZONhx.js → requirementDiagram-LRYGKXZP-BW8J4gO_.js} +1 -1
  522. package/dist/domains/dashboard/web/assets/sankeyDiagram-W5VNT64P-DQQBmLoy.js +40 -0
  523. package/dist/domains/dashboard/web/assets/sequenceDiagram-SI44F4Z6-2tDcli0Y.js +162 -0
  524. package/dist/domains/dashboard/web/assets/sizeCapture-X5ZJPWSS-4sEZLBKb.js +1 -0
  525. package/dist/domains/dashboard/web/assets/stateDiagram-OKZ733FA-OgPb8pyR.js +1 -0
  526. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-CiDNPr4P.js +1 -0
  527. package/dist/domains/dashboard/web/assets/swimlanes-SLNWSIFB-DR7lwtxd.js +2 -0
  528. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-DggHFP9q.js +8 -0
  529. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DvONX2YQ.js → timeline-definition-Z64GVDOM-DNIJVlQV.js} +4 -4
  530. package/dist/domains/dashboard/web/assets/vennDiagram-T6HMQDX7-CClhw4QZ.js +34 -0
  531. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-cf39WX2o.js → wardleyDiagram-T6FBY63Y-DzR3aFPS.js} +3 -3
  532. package/dist/domains/dashboard/web/assets/xychartDiagram-ELKLHX3M-DZhq0ZRj.js +7 -0
  533. package/dist/domains/dashboard/web/index.html +16 -16
  534. package/dist/domains/dashboard/workspace.d.ts +24 -0
  535. package/dist/domains/dashboard/workspace.d.ts.map +1 -0
  536. package/dist/domains/dashboard/workspace.js +87 -0
  537. package/dist/domains/dashboard/workspace.js.map +1 -0
  538. package/dist/domains/eval/index.d.ts +3 -0
  539. package/dist/domains/eval/index.d.ts.map +1 -1
  540. package/dist/domains/eval/index.js +3 -0
  541. package/dist/domains/eval/index.js.map +1 -1
  542. package/dist/domains/eval/standalone-context.d.ts +19 -0
  543. package/dist/domains/eval/standalone-context.d.ts.map +1 -0
  544. package/dist/domains/eval/standalone-context.js +107 -0
  545. package/dist/domains/eval/standalone-context.js.map +1 -0
  546. package/dist/domains/eval/standalone-static-collect.d.ts +22 -0
  547. package/dist/domains/eval/standalone-static-collect.d.ts.map +1 -0
  548. package/dist/domains/eval/standalone-static-collect.js +779 -0
  549. package/dist/domains/eval/standalone-static-collect.js.map +1 -0
  550. package/dist/domains/eval/user-environment.d.ts +6 -0
  551. package/dist/domains/eval/user-environment.d.ts.map +1 -0
  552. package/dist/domains/eval/user-environment.js +73 -0
  553. package/dist/domains/eval/user-environment.js.map +1 -0
  554. package/dist/domains/integrations/openspec.d.ts +1 -1
  555. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  556. package/dist/domains/integrations/openspec.js +110 -26
  557. package/dist/domains/integrations/openspec.js.map +1 -1
  558. package/dist/domains/integrations/superpowers.d.ts +5 -1
  559. package/dist/domains/integrations/superpowers.d.ts.map +1 -1
  560. package/dist/domains/integrations/superpowers.js +21 -2
  561. package/dist/domains/integrations/superpowers.js.map +1 -1
  562. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  563. package/dist/domains/skill/platform-inspect.js +11 -3
  564. package/dist/domains/skill/platform-inspect.js.map +1 -1
  565. package/dist/domains/skill/platform-install.d.ts +8 -2
  566. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  567. package/dist/domains/skill/platform-install.js +115 -34
  568. package/dist/domains/skill/platform-install.js.map +1 -1
  569. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  570. package/dist/domains/skill/project-instructions.js +5 -3
  571. package/dist/domains/skill/project-instructions.js.map +1 -1
  572. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  573. package/dist/domains/skill/uninstall.js +69 -15
  574. package/dist/domains/skill/uninstall.js.map +1 -1
  575. package/dist/domains/workflow-contract/hook-write-policy.d.ts +9 -0
  576. package/dist/domains/workflow-contract/hook-write-policy.d.ts.map +1 -0
  577. package/dist/domains/workflow-contract/hook-write-policy.js +52 -0
  578. package/dist/domains/workflow-contract/hook-write-policy.js.map +1 -0
  579. package/dist/domains/workflow-contract/index.d.ts +3 -0
  580. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  581. package/dist/domains/workflow-contract/index.js +2 -0
  582. package/dist/domains/workflow-contract/index.js.map +1 -1
  583. package/dist/domains/workflow-contract/project-config.d.ts +3 -1
  584. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  585. package/dist/domains/workflow-contract/project-config.js +119 -19
  586. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  587. package/dist/domains/workflow-contract/project-gitignore.d.ts +9 -0
  588. package/dist/domains/workflow-contract/project-gitignore.d.ts.map +1 -0
  589. package/dist/domains/workflow-contract/project-gitignore.js +108 -0
  590. package/dist/domains/workflow-contract/project-gitignore.js.map +1 -0
  591. package/dist/domains/workflow-contract/protected-project-path.d.ts +13 -0
  592. package/dist/domains/workflow-contract/protected-project-path.d.ts.map +1 -1
  593. package/dist/domains/workflow-contract/protected-project-path.js +83 -0
  594. package/dist/domains/workflow-contract/protected-project-path.js.map +1 -1
  595. package/dist/domains/workflow-contract/types.d.ts +4 -0
  596. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  597. package/dist/platform/install/platforms.d.ts +3 -1
  598. package/dist/platform/install/platforms.d.ts.map +1 -1
  599. package/dist/platform/install/platforms.js +22 -2
  600. package/dist/platform/install/platforms.js.map +1 -1
  601. package/dist/platform/paths/git-worktree.d.ts +8 -1
  602. package/dist/platform/paths/git-worktree.d.ts.map +1 -1
  603. package/dist/platform/paths/git-worktree.js +41 -7
  604. package/dist/platform/paths/git-worktree.js.map +1 -1
  605. package/dist/platform/process/external-command.d.ts +13 -0
  606. package/dist/platform/process/external-command.d.ts.map +1 -0
  607. package/dist/platform/process/external-command.js +45 -0
  608. package/dist/platform/process/external-command.js.map +1 -0
  609. package/dist/platform/process/git.d.ts +12 -0
  610. package/dist/platform/process/git.d.ts.map +1 -0
  611. package/dist/platform/process/git.js +86 -0
  612. package/dist/platform/process/git.js.map +1 -0
  613. package/dist/platform/process/spawn-command.d.ts +8 -0
  614. package/dist/platform/process/spawn-command.d.ts.map +1 -0
  615. package/dist/platform/process/spawn-command.js +113 -0
  616. package/dist/platform/process/spawn-command.js.map +1 -0
  617. package/eval/.env.example +115 -0
  618. package/eval/README.md +237 -14
  619. package/eval/langfuse/.env.example +9 -0
  620. package/eval/langfuse/tests/conftest.py +146 -0
  621. package/eval/langfuse/tests/tasks/test_tasks.py +109 -0
  622. package/eval/langfuse/tests/test_adapter.py +272 -0
  623. package/eval/langsmith/.env.example +16 -0
  624. package/eval/langsmith/tests/conftest.py +10 -1
  625. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +4 -2
  626. package/eval/local/tasks/comet-native-clarification/validation/test_native_clarification.py +9 -21
  627. package/eval/local/tasks/comet-native-clarification-depth/validation/test_native_clarification_depth.py +4 -7
  628. package/eval/local/tasks/comet-native-clarification-modes/validation/test_native_clarification_modes.py +4 -10
  629. package/eval/local/tasks/comet-native-interrupted-transition/instruction.md +1 -1
  630. package/eval/local/tasks/comet-native-interrupted-transition/validation/test_native_interrupted_transition.py +15 -16
  631. package/eval/local/tasks/comet-native-repository-fact/instruction.md +2 -2
  632. package/eval/local/tasks/comet-native-repository-fact/validation/test_native_repository_fact.py +8 -2
  633. package/eval/local/tasks/comet-native-wave-b-decision-resume/instruction.md +8 -4
  634. package/eval/local/tasks/comet-native-wave-b-decision-resume/task.toml +6 -6
  635. package/eval/local/tasks/comet-native-wave-b-decision-resume/validation/test_native_wave_b_decision_resume.py +126 -135
  636. package/eval/local/tasks/comet-native-wave-c-verification-integrity/instruction.md +6 -6
  637. package/eval/local/tasks/comet-native-wave-c-verification-integrity/task.toml +8 -8
  638. package/eval/local/tasks/comet-native-wave-c-verification-integrity/validation/test_native_wave_c_verification_integrity.py +97 -317
  639. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/instruction.md +7 -7
  640. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/task.toml +4 -4
  641. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/validation/test_native_wave_d_stagnation_stop.py +130 -199
  642. package/eval/local/tasks/comet-native-wave-e-parallel-safety/instruction.md +5 -5
  643. package/eval/local/tasks/comet-native-wave-e-parallel-safety/task.toml +8 -8
  644. package/eval/local/tasks/comet-native-wave-e-parallel-safety/validation/test_native_wave_e_parallel_safety.py +135 -239
  645. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -2
  646. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/instruction.md +3 -3
  647. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/task.toml +6 -6
  648. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/validation/test_native_wave_f_dashboard_readonly.py +81 -439
  649. package/eval/local/tasks/comet-native-workflow/instruction.md +5 -4
  650. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +145 -502
  651. package/eval/local/tasks/index.yaml +5 -5
  652. package/eval/local/tests/conftest.py +701 -80
  653. package/eval/local/tests/scaffold/fixtures/custom-agent/adapter.yaml +19 -0
  654. package/eval/local/tests/scaffold/test_agents.py +76 -0
  655. package/eval/local/tests/scaffold/test_aligned_comparison.py +70 -0
  656. package/eval/local/tests/scaffold/test_auto_tasks.py +350 -0
  657. package/eval/local/tests/scaffold/test_conftest_helpers.py +267 -18
  658. package/eval/local/tests/scaffold/test_custom_agents.py +174 -0
  659. package/eval/local/tests/scaffold/test_eval_context.py +217 -0
  660. package/eval/local/tests/scaffold/test_execution.py +364 -0
  661. package/eval/local/tests/scaffold/test_inline_tasks.py +56 -0
  662. package/eval/local/tests/scaffold/test_langfuse_trajectory.py +263 -0
  663. package/eval/local/tests/scaffold/test_langsmith_conftest.py +63 -0
  664. package/eval/local/tests/scaffold/test_logging.py +162 -0
  665. package/eval/local/tests/scaffold/test_manifest_tasks.py +76 -0
  666. package/eval/local/tests/scaffold/test_manifests.py +396 -0
  667. package/eval/local/tests/scaffold/test_native_aligned_eval.py +163 -35
  668. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +75 -2054
  669. package/eval/local/tests/scaffold/test_profiles.py +64 -6
  670. package/eval/local/tests/scaffold/test_task_resolution.py +212 -0
  671. package/eval/local/tests/scaffold/test_tasks.py +38 -52
  672. package/eval/local/tests/scaffold/test_utils.py +480 -4
  673. package/eval/local/tests/tasks/test_tasks.py +219 -17
  674. package/eval/local/treatments/comet/comet_native_phase1.yaml +7 -4
  675. package/eval/pyproject.toml +9 -4
  676. package/eval/scaffold/__init__.py +6 -0
  677. package/eval/scaffold/docker/agent-overlay.Dockerfile +41 -0
  678. package/eval/scaffold/python/__init__.py +128 -20
  679. package/eval/scaffold/python/agents.py +239 -0
  680. package/eval/scaffold/python/aligned_comparison.py +156 -27
  681. package/eval/scaffold/python/auto_tasks.py +700 -0
  682. package/eval/scaffold/python/custom_agents.py +172 -0
  683. package/eval/scaffold/python/eval_context.py +236 -0
  684. package/eval/scaffold/python/eval_schema.py +135 -0
  685. package/eval/scaffold/python/execution.py +544 -0
  686. package/eval/scaffold/python/generated_task_cache.py +230 -0
  687. package/eval/scaffold/python/generic_llm_judge.py +41 -14
  688. package/eval/scaffold/python/inline_tasks.py +118 -0
  689. package/eval/scaffold/python/judge_config.py +158 -37
  690. package/eval/scaffold/python/langfuse_adapter.py +1023 -0
  691. package/eval/scaffold/python/llm_judge.py +68 -11
  692. package/eval/scaffold/python/logging.py +157 -17
  693. package/eval/scaffold/python/manifest_tasks.py +69 -0
  694. package/eval/scaffold/python/manifests.py +443 -22
  695. package/eval/scaffold/python/native_eval.py +10 -5
  696. package/eval/scaffold/python/paths.py +11 -1
  697. package/eval/scaffold/python/task_resolution.py +176 -0
  698. package/eval/scaffold/python/tasks.py +17 -4
  699. package/eval/scaffold/python/utils.py +167 -11
  700. package/eval/scaffold/python/validation/core.py +48 -2
  701. package/eval/scaffold/python/validation/generic_rubric.py +9 -0
  702. package/eval/scaffold/python/validation/native_v4.py +249 -0
  703. package/eval/scaffold/python/validation/native_wave.py +4 -5
  704. package/eval/scaffold/python/validation/native_workflow.py +199 -98
  705. package/eval/scaffold/python/validation/rubric.py +130 -2
  706. package/eval/scaffold/shell/agent-runtime-config.sh +88 -0
  707. package/eval/scaffold/shell/docker.sh +534 -33
  708. package/eval/scaffold/shell/run-agent-runtime.sh +49 -0
  709. package/eval/scaffold/shell/run-claude-loop.sh +153 -14
  710. package/eval/schemas/comet.eval/v1alpha1.schema.json +244 -0
  711. package/package.json +9 -3
  712. package/assets/skills/comet-native/scripts/comet-native-check.mjs +0 -179
  713. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +0 -179
  714. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +0 -151
  715. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +0 -187
  716. package/dist/domains/comet-native/native-check-entry.d.ts +0 -2
  717. package/dist/domains/comet-native/native-check-entry.d.ts.map +0 -1
  718. package/dist/domains/comet-native/native-check-entry.js +0 -4
  719. package/dist/domains/comet-native/native-check-entry.js.map +0 -1
  720. package/dist/domains/comet-native/native-checkpoint-entry.d.ts +0 -2
  721. package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +0 -1
  722. package/dist/domains/comet-native/native-checkpoint-entry.js +0 -4
  723. package/dist/domains/comet-native/native-checkpoint-entry.js.map +0 -1
  724. package/dist/domains/comet-native/native-evidence-entry.d.ts +0 -2
  725. package/dist/domains/comet-native/native-evidence-entry.d.ts.map +0 -1
  726. package/dist/domains/comet-native/native-evidence-entry.js +0 -4
  727. package/dist/domains/comet-native/native-evidence-entry.js.map +0 -1
  728. package/dist/domains/comet-native/native-receipt-entry.d.ts +0 -2
  729. package/dist/domains/comet-native/native-receipt-entry.d.ts.map +0 -1
  730. package/dist/domains/comet-native/native-receipt-entry.js +0 -4
  731. package/dist/domains/comet-native/native-receipt-entry.js.map +0 -1
  732. package/dist/domains/dashboard/web/assets/arc-ClrSujVb.js +0 -1
  733. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-B4A_t84A.js +0 -36
  734. package/dist/domains/dashboard/web/assets/blockDiagram-GPEHLZMM-D72u2953.js +0 -132
  735. package/dist/domains/dashboard/web/assets/channel-B_u-_i2t.js +0 -1
  736. package/dist/domains/dashboard/web/assets/chunk-AQP2D5EJ-BA_zgMXZ.js +0 -231
  737. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BpA7BPgX.js +0 -1
  738. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BpA7BPgX.js +0 -1
  739. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-B0Bk5oiP.js +0 -4
  740. package/dist/domains/dashboard/web/assets/demo-DZYPLZpF.js +0 -25
  741. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-tvTUiBA2.js +0 -43
  742. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-BZfcK29q.js +0 -10
  743. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-D5bJnW2C.js +0 -24
  744. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-DTwWdzWJ.js +0 -24
  745. package/dist/domains/dashboard/web/assets/erDiagram-TEJ5UH35-BbvrdCp9.js +0 -85
  746. package/dist/domains/dashboard/web/assets/flowDiagram-I6XJVG4X-DgbR7Tcc.js +0 -162
  747. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-wWMOA7F4.js +0 -292
  748. package/dist/domains/dashboard/web/assets/index-Bk1o-4VO.css +0 -1
  749. package/dist/domains/dashboard/web/assets/index-g8vyW0R_.js +0 -257
  750. package/dist/domains/dashboard/web/assets/layout-SsrduOYp.js +0 -1
  751. package/dist/domains/dashboard/web/assets/mermaid.core-DZUcsoG4.js +0 -301
  752. package/dist/domains/dashboard/web/assets/pieDiagram-4H26LBE5-Dn67tdOF.js +0 -30
  753. package/dist/domains/dashboard/web/assets/purify.es-VaSPOPhr.js +0 -3
  754. package/dist/domains/dashboard/web/assets/sankeyDiagram-5OEKKPKP-C3u-4dOk.js +0 -40
  755. package/dist/domains/dashboard/web/assets/sequenceDiagram-3UESZ5HK-Xd3ByTVF.js +0 -162
  756. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CJGHL7Up.js +0 -1
  757. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-rKvBgr6I.js +0 -1
  758. package/dist/domains/dashboard/web/assets/vennDiagram-CIIHVFJN-B-L4qWy4.js +0 -34
  759. package/dist/domains/dashboard/web/assets/xychartDiagram-2RQKCTM6-Dk1vcm3u.js +0 -7
  760. /package/assets/skills/{comet → comet-classic}/reference/classic-layout.md +0 -0
  761. /package/assets/skills-zh/{comet → comet-classic}/reference/classic-layout.md +0 -0
@@ -1,219 +1,108 @@
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 负责状态、边界和恢复。
9
-
10
- ## 核心规则
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
- ```
8
+ Native 把需求、完整目标规格、当前进度和验收结论保存在项目中。每完成一个阶段都回到 Runtime 读取下一步,当前只处理 Runtime 指定的阶段。
9
+ ## 硬性边界
36
10
 
11
+ - 磁盘中的 `.comet/config.yaml`、当前 change、`comet-state.yaml` 和正式 Markdown 是工作依据,聊天记忆只作辅助。
12
+ - Runtime 管理工作流状态、本机任务、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 `comet native` 命令完成,用户不手工执行这些命令。
13
+ - 命令不可用时报告 Comet 安装不完整并停止。参数和输出以 `comet native <command> --help` 为准。
14
+ - Builder 提交候选,新的只读 Verifier subagent 或独立 Agent 任务作出验收判断。
15
+ - Native 主流程由本 Skill 和 Runtime 完成,不依赖任何外部 Skill。
37
16
  ## 开始或恢复
38
17
 
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
- ```
18
+ 1. 已知 change 名称时,直接运行 `comet native status <change-name> --details --json`;名称未知时才运行 `comet native status --json`,确定目标后再查询该 change 的详细状态。
19
+ 2. 当前阶段需要完整验收列表时才执行 `nextPageArgs` 中的分页命令;需要编辑或核对正式正文时才运行 `show` 或读取对应 brief/Spec。
20
+ 3. active change 已存在时,进入返回的 `workspace.projectRoot` 并 `select`。Runtime 会扫描已登记 Worktree,优先返回绑定分支匹配的工作区;只有多个同样匹配的候选才让用户选择。
21
+ 4. 没有对应 active change 时才创建,并使用配置指定的产物目录。
22
+ ### 创建 change
80
23
 
81
- 创建 worktree 前,把 `.worktrees/` 写入仓库本地 Git exclude(Git common dir 的 `info/exclude`),不得为此修改 tracked `.gitignore`。Agent 必须在新工作目录中自动继续,不把进入目录的操作交给用户。
24
+ 先确定小写 kebab-case 名称,再按[工作区选择参考](reference/workspace.md)决定使用当前目录、创建分支还是创建 worktree。用户明确说并行、同时处理或多个会话时自动选择 `worktree`,不再询问三种方式。
82
25
 
83
- worktree 必须从已解析的本地目标分支提交创建。源目录有未提交内容时,先归因:可证明与新 change 无关的内容留在原目录;可能属于新 change 且无法从该提交带入时,等待用户决定如何保留,不静默提交、复制或遗漏。目标目录必须从目标分支获得一致配置,或通过公开 `comet native init` 建立合法配置并核对 artifact root、language、clarification、archive、verify 与 snapshot 语义;无法证明一致时停止。不得复制源目录的 `.comet/current-change.json`。
26
+ CLI 会在创建 change 前完成分支或 worktree 绑定、复用已登记的 change 分支、在分支仍存在但登记 Worktree 已移除时重建 Worktree、维护仓库本地排除规则、核对配置并创建可跨设备恢复的状态。随后进入命令返回的 `preparation.projectRoot`;后续命令不得继续在原目录执行。
84
27
 
85
- 目标配置就绪后、运行 `new` 前,Agent 必须在新工作目录中依次执行:
28
+ 如果准备没有完成,保留已经创建的资源,展示 `preparation` 中的失败原因,并按 Runtime 或用户给出的恢复方向继续。
29
+ ## 按需读取
86
30
 
87
- ```bash
88
- comet doctor --repair --scope project
89
- comet doctor --scope project --json
90
- ```
91
-
92
- 只有 Doctor 确认 Hook runtime 为当前版本、该平台恰好存在一个以目标项目为根的 Router,且没有遗留或重复 Comet Hook 时才继续。Agent 自行在新工作目录中执行这些命令,不让用户手动进入目录;不得从源目录复制 `.comet/current-change.json`。若项目配置未从目标分支继承,则先用公开 `comet native init` 按源项目的已核对语义建立配置,再执行上述 Doctor 序列。
93
-
94
- worktree 创建只完成部分步骤时立即停止:报告原始错误、目标分支与目标路径、已明确创建的分支/worktree/exclude/config/change 资源,以及可恢复的下一步。只能清理可证明由本次操作新建且删除安全的资源;无法证明归属时保留现场,绝不删除已有或可能属于用户的 worktree、分支与文件。
95
-
96
- Runtime 会在 `new` 的同一个 mutation lock 中重新检查当前目录是否已出现 active change。系统默认的 `current` 因竞态返回 `workspace-isolation-required` 时,自动按默认 `worktree` 重新准备并创建;用户明确选择的方式若在执行前失效,停止并重新确认,不擅自换方式。
97
-
98
- 没有 workspace v3 绑定的旧 active change 保持兼容:不自动生成 worktree、不移动文件、不刷新 baseline;同一旧目录内仍一次只选择一个 change。只有真实 baseline 或 scope 漂移时才按 Runtime 失败关闭,并让用户决定恢复、重建或放弃。
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)。
31
+ 确认 phase 后只读取需要的一份 reference:
108
32
 
33
+ - Shape:必须读取并执行[澄清参考](reference/clarification.md);
34
+ - 实际编辑 brief/完整目标规格,或查看验收报告时读取[产物参考](reference/artifacts.md);
35
+ - 正常推进时,直接执行 Runtime 在 `continuation` 中给出的命令。只有返回字段含义不清、命令输入被拒绝、无法启动 Verifier、Verifier 执行报错,或 Verifier 要求用户补充信息时,才读取[命令参考](reference/commands.md);
36
+ - 只有任务因进程中断、换设备后本机状态缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏而无法继续时,才读取[恢复参考](reference/recovery.md)。
109
37
  ## Shape
110
38
 
111
- 先调查能从仓库、工具和运行环境查明的事实。只有不同选择会实质改变用户可见结果,并且无法从已有要求可靠确定时,才询问用户;实现方式由你决定。
39
+ 先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 `native.clarification_mode` 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。
40
+
41
+ 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择保留在实现和测试中,只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。大型需求需要拆分时,在 Supervisor Change 根目录维护 `children.yaml`,用 `depends_on` 表达真实先后关系,并用 `covers` 覆盖 Supervisor Change 验收项;数组顺序只用于稳定展示和同等就绪时的优先级。
112
42
 
113
- 按 `clarification_mode` 执行澄清参考。即使初步判断没有未决行为,也必须完成其中的信息分类和静默假设检查。每次用户回答后,立即更新同一个 change 的 Decisions、brief 和完整目标规格。未解决项继续以 `[blocking]` 保存;存在阻塞项时不修改项目实现,也不推进阶段。
43
+ 大型需求在最终 Shape 确认前执行一次拆分检测:只有至少两个结果可独立实现和验证、验收项能完整映射且有真实依赖/并行价值时建议 Supervisor Change 模式;目标紧耦合、反复修改同一核心区域、协调成本更高或用户要求单 change 时保持单一 Native change;需求文字长、任务条目多本身不能触发拆分。
44
+ 建议拆分时,Skill 将 `children.yaml` 草案、执行波次和验收覆盖摘要放入一次 Shape 确认;用户可确认、调整或保持单 change。确认前不得创建子 change、worktree 或派发 Agent。
45
+ 确认后,Skill 从 Runtime 的 `readyChildren` 自动派发当前可执行子 change;支持并行时同时推进,不支持并行时按顺序执行。子 change 范围严格继承父确认,出现新的用户可见决定时回到父 Shape。
46
+ 恢复 `/comet-native` 时根据 Runtime 状态继续,不重复创建已有 child 或 worktree。
47
+ 未解决问题保持 `[blocking]`;有阻塞项时不修改项目实现。完成标准:所有会影响用户可见结果的选择和未明说的假设均已处理,没有 `[blocking]`,用户明确确认目标、范围、关键决定、验收项和非目标,并且 Runtime 已进入 Build。只有用户明确确认后才使用后续指令中含 `--confirmed` 的命令推进。
114
48
 
115
- 所有用户决定处理完后,重新检查是否仍有静默假设,并向用户提供目标、范围、关键决定、验收标准和非目标的共享理解摘要。只有用户明确确认后,才移除最终阻塞项并推进:
49
+ ## Build ↔ Verify Loop
116
50
 
117
- ```text
118
- comet native next <change-name> --summary <摘要> --confirmed
119
- ```
51
+ Build 和 Verify 组成一个有界验收循环(Loop):Builder 提交候选,Runtime 执行必要检查,再由新的只读 Verifier 验收。验收未通过时回到 Build,完成修改并提交下一轮候选;全部通过时进入 Archive。
120
52
 
121
- brief 或规格改变已确认的行为时,重新取得用户确认;不要手工修改确认状态。
53
+ `iteration` 表示实现候选的轮次,`attempt` 表示同一候选启动 Verifier 的次数。连续失败、没有实际进展或 Verifier 多次执行出错时,Runtime 会在预算上限处进入等待用户或阻塞状态。所有计数都由 Runtime 更新,Agent 只执行最新 `continuation`。
122
54
 
123
55
  ## Build
124
56
 
125
- 实现满足 brief 和完整目标规格的最简单可靠方案。可以分批完成;长任务可使用 checkpoint 保存恢复摘要,但 checkpoint 不是完成证据。
57
+ 首次实现时读取当前 brief、完整目标规格和全部验收项。如果 Verify 未通过并返回 Build,先处理 Verifier 指出的未通过项、无法继续验证的问题和失败检查;再次提交前重新核对完整规格与全部验收项,避免只修报错点而遗漏其他要求。
126
58
 
127
- 需求变化时先更新正式产物。出现新的用户决定时保持在 Build,但重新执行 Shape 的澄清与确认边界:保存 `[blocking]`、暂停实现并询问用户。用户确认后,更新 Decisions、brief 和完整目标规格并移除阻塞项;离开 Build 时执行 Runtime 返回的命令并传入 `--confirmed`。
59
+ 确认一次 Supervisor Change Shape 即授权严格派生的子 change,不要求用户重复确认相同范围。Skill 只执行 Runtime continuation 返回的动作,并在每个 child 完成后重新读取 `readyChildren`,继续下一波;Supervisor Change 最后仍由 Verify 验证完整验收项。
128
60
 
129
- 候选实现完成后,对照完整规格和全部 acceptance 复核是否仍有遗漏,再提供真实项目产物推进:
61
+ 状态包含 `children` 时,当前 change 是 Supervisor Change:不要运行 Supervisor Change Builder,只推进 `readyChildren`。每个 child 都是普通 Native change,必须在独立 worktree 中创建,以 Supervisor Change 的 `workspace.changeBranch` 为目标分支;没有依赖的 child 可以并行 Build/Verify,但 Archive 必须逐个使用 `finish=merge` 合入 Supervisor Change 分支。先提交 Supervisor Change 契约基线以保持集成工作区干净;只有 child 的 Archive 已合入 Supervisor Change 分支才算 `done`,随后才从更新后的 Supervisor Change HEAD 创建依赖它的 child。全部 child 为 `done` 后,执行 Supervisor Change continuation 进入 Verify,由新的 Verifier 在最终集成分支上检查 Supervisor Change 的完整验收项。Supervisor Change Verify 未通过时不要重开已归档 child;按 `repair-child` 提示在 `children.yaml` 中追加覆盖失败验收项的唯一 repair child,重新确认 Supervisor Change Shape 后继续。
130
62
 
131
- ```text
132
- comet native next <change-name> \
133
- --summary <摘要> \
134
- --artifact <项目内路径> \
135
- [--confirmed]
136
- ```
63
+ 需求变化时先判断归属:
137
64
 
138
- 没有代码变化或 Runtime 无法证明完整 scope 时,读取命令参考。不得把未知或不完整范围声明为 complete。
65
+ - 当前需求只是实现有遗漏:从 Verify 或 Archive 使用 `--return-to-build` 回到 Build;
66
+ - 用户可见行为或验收标准发生变化:回到 Shape,更新正式产物并重新确认;
67
+ - 与当前需求无关:保留给另一个 change。
139
68
 
140
- ## Completion Loop
69
+ 用户明确补充当前范围时,按同一规则处理。
141
70
 
142
- 进入 Build 后按以下循环收敛:
71
+ 候选完成后,按 Runtime 在 `continuation` 中提供的输入模板提交一份精简的 Builder 交接摘要,包括:本轮做了什么、处理了哪些验收项、实际运行或没有运行哪些开发期检查,以及还有哪些已知限制。
143
72
 
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。
73
+ 这份 handoff 保存在 `comet-state.yaml` 中,不会生成单独文件,也不代表已经验收通过。Runtime 会把它交给 Verifier,Builder 提交一次即可。
149
74
 
150
- `blocked` 会暂停正常 Build → Verify 循环并进入恢复分支。处理 findings 后,根据新的 continuation 从第 1 步恢复循环。只有 `done`、`await-user` 或调用方明确要求停止时,才结束当前工作。一次 Agent turn、一次 checkpoint、一次 `blocked` 或 Agent 自述“已完成”都不是终态。Agent 负责发现并修复缺口,Runtime 负责判断是否完成。
75
+ 完成标准:实现和相关检查达到可验收状态,完整验收项已重新核对,Runtime 接受 handoff 并进入 Verify。
151
76
 
152
77
  ## Verify
153
78
 
154
- 根据 acceptance、完整目标规格和改动风险运行真实验证。用实际结果完成 `verification.md` 和验收证据;未运行或失败的检查不能写成通过。
79
+ Runtime 要求启动 Verifier(`dispatch-verifier`)时,先把当前候选需要运行的测试和检查命令填入 `inputOptions.template`,由 Runtime 统一执行。Runtime 会复用已经完成的检查;是否重试或补充检查,以最新 `continuation` 为准。
155
80
 
156
- 使用 Runtime 返回的 acceptance ID 和 receipt。需要生成证据块或记录 automated/manual receipt 时,读取产物与命令参考。
81
+ Runtime 返回 `verifierDispatch` 后,立即启动一个新的只读 Verifier subagent。平台不支持 subagent 时,启动一个与 Builder 会话分开的新 Agent 任务。
157
82
 
158
- 只有 Runtime 接受完整且新鲜的验收矩阵和 required checks 时才能提交 `pass`。相关实现、规格、报告或证据改变后重新验证。
83
+ Verifier 先读取验收项、brief、完整目标 Spec、实际实现和 Runtime 检查结果,最后再把 Builder handoff 当作调查线索,保持验收判断独立。
159
84
 
160
- 提交 Verify 时只传 `--result` 和 `--report`;`next` 不接受 `--receipt` 或其他调用方提供的 required-check 参数。Runtime 会先校验报告格式、完整验收矩阵和 acceptance receipt,只有这些输入有效后才执行或复用当前 scope 的内置 required check。报告无效时先修正报告,不要反复重试同一个 `next` 命令。
85
+ Verifier 保持只读。如果现有检查不足,就在 Runtime 返回的 `inputOptions.template` 中列出还需要运行哪些检查,由 Runtime 执行并把结果返回给 Verifier。
161
86
 
162
- `fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next` 当作修复。`repair-stagnation-stop` 由 Agent 按恢复参考提出新假设并使用 Runtime 返回的 override;只有 continuation 要求 `repair-continuation-decision` 时才等待用户选择。
87
+ Verifier 最终必须逐项标记为通过(`passed`)、未通过(`failed`)或暂时无法验证(`blocked`),一项不能漏,也不能重复。未通过或无法验证时,写出下一轮 Build 可直接处理的原因。无法启动 Verifier、Verifier 执行出错或缺少外部信息时,按命令参考和最新 `continuation` 处理。
163
88
 
164
- Verify 失败的中间循环不运行 Archive,也不触发归档确认。持续执行 Build → Verify,直到 pass、Runtime 阻塞或需要用户决定。
89
+ 完成标准:Runtime 已接受完整的 Verifier 结果,并明确进入 Build、Archive、等待用户(`await-user`)、阻塞(`blocked`)或完成(`done`)中的一种状态。
165
90
 
166
91
  ## Archive
167
92
 
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,不把某一方静默覆盖。
93
+ 只有 `continuation` 允许 Archive 时才继续。Archive 直接使用已经接受的验收结果。`branch` 或 `worktree` 需要收尾选择时,一次展示实际 change 分支、目标分支和目录,让用户选择合并(merge)、推送(push)、创建 PR、保留工作区(keep)或暂不归档。
205
94
 
206
- ## Continuation 与停止条件
95
+ 只提交属于当前 change 的实现和正式产物,保留其他用户改动。执行 Runtime 返回的 `commandArgs`,再检查工作区收尾结果 `workspaceFinishResult`;结果为阻塞(`blocked`)时保留现场,并执行 `recoveryArgs` 中的恢复命令。
207
96
 
208
- Shape、Build 和 Verify 的 transition 都会返回 `next: auto | manual`、`continuation.disposition: continue | await-user | blocked | done`、所需输入与下一步动作;Archive 不通过 `next` 推进,归档成功才返回 `done`。每次 transition 后按该 Runtime continuation 行动:
97
+ 完成标准:状态为 `done`,并且用户授权的工作区收尾结果为已完成(`completed`)或已保留(`kept`);其他结果按 `continuation` 继续。
209
98
 
210
- - `continue`:重新读取 phase 和当前所需产物后继续;
211
- - `await-user`:等待确实需要用户决定或补充的输入;
212
- - `blocked`:暂停正常循环,处理 findings,必要时读取恢复参考;处理后按新的 continuation 恢复,不因 `blocked` 本身结束任务;
213
- - `done`:change 已完成。
99
+ ## 后续指令
214
100
 
215
- `next: auto` 只表示本次 transition 成功,不表示后续步骤已执行。调用方明确要求在某次 transition 后停止时,严格按“更新正式产物 → 执行一次允许的 transition → transition 成功后不再调用工具 → 输出约定标记并结束本轮”执行;即使 continuation 为 `continue` 也不得继续执行后续步骤。
101
+ 每次命令后只处理最新的 `continuation`:
216
102
 
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`。
103
+ - `continue`:执行 `commandArgs`,并按模板填写 `inputOptions`;
104
+ - `await-user`:等待列出的用户决定;
105
+ - `blocked`:先处理列出的阻塞原因或恢复动作;
106
+ - `done`:结束。
218
107
 
219
- 摘要、理由、报告和产物中不得写入 token、密码、私钥、连接串或其他凭据。
108
+ 执行会修改状态的命令后,重新查询该 change 的详细状态,确认当前阶段、验收循环、状态版本和工作目录。只有需要正式正文时才运行 `show`。
@@ -0,0 +1,3 @@
1
+ interface:
2
+ display_name: "Comet Native"
3
+ short_description: "Comet Native workflow"
@@ -1,54 +1,35 @@
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
13
+ children.yaml
12
14
  specs/<capability>/spec.md
13
15
  verification.md
14
16
  ```
15
17
 
16
- 项目配置、当前 change、change 状态和 `runtime/workspace.json` 用于读取,不要手工改变 Runtime 管理的 phase、确认、规格操作、workspace 绑定、scope、evidence、checkpoint、锁或事务字段。
18
+ Agent 只编辑 brief、完整目标规格和 Supervisor Change 的 `children.yaml`。`comet-state.yaml` 与 `verification.md` 由 Runtime 管理;Runtime 第一次接受 Verifier 结果后生成报告。
17
19
 
18
- 新建 change 的 `comet.native.workspace.v3` 记录 `isolation`、`changeBranch`、`targetBranch`、Archive 前由 `--finish` 持久化的收尾决定和物理目录身份。它用于跨会话恢复和写入保护,不是会话 lease;旧 v1/v2 元数据保持兼容,不得为了启用隔离而手工迁移。
20
+ 本机 Runtime 固定保存在被 Git 忽略的 `.comet/runtime/native/`。每个 active change 的本机状态和日志位于 `changes/<change-name>/state.json` 与 `logs/`;项目级锁和短期事务也放在这个 Runtime 目录中。这些机器文件始终交给 Runtime 创建、迁移和修复。
19
21
 
20
- Native artifact root 只由 `.comet/config.yaml` 指定。不要扫描其他 workflow 的目录,也不要自行创建第二个状态根。
22
+ ## 跨设备状态与报告
21
23
 
22
- ## Scope 快照边界
24
+ `comet-state.yaml` 是跨设备恢复时唯一可信的工作流状态,记录当前阶段、状态、版本、验收循环次数、验收结果、Builder 交接摘要、阻塞原因、下一步、检查摘要和精简历史。本机进程、绝对路径和完整命令输出只保留在本机 Runtime 中。该文件由 Runtime 更新。
23
25
 
24
- Git 快照包含 tracked 和未被 ignore 的 untracked 文件,submodule/gitlink 作为原子条目。非 Git 项目使用有界物理树快照。
26
+ `verification.md` 是 Runtime 根据同一版本的 YAML 生成的可读验收报告。报告缺失或版本落后时,Runtime 只重建报告,不会因此重新运行检查或 Verifier。工作流进度始终以 YAML 为准,不能通过修改 Markdown 报告来推进。
25
27
 
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`。配置改变不会让旧证据继续有效,也不会自动清除已有阻塞项。
28
+ `.comet/config.yaml` 决定使用哪种工作流,以及 change 产物保存在哪个目录。使用非默认产物目录并需要跨设备恢复时,应同步该文件;其余 `.comet/*` 只保留在本机。
48
29
 
49
30
  ## Brief
50
31
 
51
- `brief.md` 使用以下一级标题:
32
+ `brief.md` 使用以下非空一级标题:
52
33
 
53
34
  ```text
54
35
  # Outcome
@@ -61,76 +42,30 @@ native:
61
42
  # Verification expectations
62
43
  ```
63
44
 
64
- Outcome、Scope、Non-goals 和 Acceptance examples 必须有实质内容。
65
-
66
- Open questions 中的阻塞项使用固定格式:
45
+ Open questions 中只有真实未解决的用户问题使用:
67
46
 
68
47
  ```text
69
48
  - [blocking] <Sequential 当前问题>
70
- - [blocking] Q1: <问题>
49
+ - [blocking] Q1: <Batch 问题>
71
50
  - [blocking] CONFIRM: <最终共享理解>
72
51
  ```
73
52
 
74
- 未回答或不明确的问题继续保留。用户确认后,把决定写入 Decisions 和完整目标规格,再移除对应阻塞项。不要保存隐藏推理。
75
-
76
- ## 完整目标规格
53
+ 每个决定确认后立即写入 Decisions 和完整目标规格,再移除对应阻塞项。正式产物只记录结论和理由,不记录模型的隐藏推理过程。
77
54
 
78
- 规格写在:
55
+ 验收标准必须具体、可观察且互不重复。使用简单顺序 ID,例如 `A1`、`A2`、`A3`;ID 只用于结果映射,不从内容计算,也不代表文件身份。Runtime 在 Shape 确认时保存完整验收文字及其来源。Supervisor Change 的 `children.yaml` 使用 `comet.native.children.v1`,每个 child 只包含 `name`、`depends_on` 和 `covers`。名称必须唯一,依赖必须存在且无环,全部 Supervisor Change 验收 ID 都必须被覆盖。Runtime 将其与 Supervisor Change 验收项一起确认;修改后 Supervisor Change 返回 Shape。
79
56
 
80
- ```text
81
- changes/<change-name>/specs/<capability>/spec.md
82
- ```
57
+ ## 完整目标规格
83
58
 
84
- 它描述归档后 capability 应有的完整行为,不是相对旧文本的增量 patch。
59
+ 每个 `specs/<capability>/spec.md` 描述归档后 capability 的完整行为,而不是只写相对旧文本的变化:
85
60
 
86
- - 新 capability:创建完整规格。
87
- - 已有 capability:写出替换后的完整规格。
88
- - 删除 capability:运行 `comet native spec remove`,不要只删除文件。
61
+ - 新 capability:写完整规格;
62
+ - 已有 capability:写修改后的完整规格;
63
+ - 删除 capability:使用 CLI 的 `spec remove`,不只删除文件。
89
64
 
90
- Runtime 负责记录 create、replace、remove 和 canonical 基线。发生 canonical 冲突时,先重读并改写完整目标规格,再使用 `spec rebase`;不要手改 Runtime 状态或 hash。
65
+ 如果项目中已经归档的正式 Spec 与当前 change 发生冲突,先重读最新 Spec,再按用户意图改写当前 change 的完整目标规格,最后执行 Runtime 返回的重新对齐(rebase)动作。Spec 操作类型和工作流状态仍由 Runtime 管理。
91
66
 
92
67
  ## Verification
93
68
 
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` 说明真实失败或跳过原因。
69
+ 报告展示每个验收项的结果和原因、实际检查的脱敏命令预览与状态、阻塞项、风险以及精简的验收循环历史。完整命令输出只保留在本机日志中。
135
70
 
136
- 不要手工排版机器块,不要复用旧 change 的 evidence ref,也不要把失败、跳过或阻塞结果写成通过。
71
+ 验收结论由 Runtime 根据 YAML 生成。失败、阻塞、未运行或超时的项目保持原状态;只有当前候选的全部验收项都有结论,并且必要检查成功,最终结果才是通过。
@@ -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. 等待用户明确确认;