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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/README.md +1 -1
  2. package/assets/manifest.json +15 -1
  3. package/assets/skills/comet/SKILL.md +10 -12
  4. package/assets/skills/comet/reference/classic-layout.md +2 -2
  5. package/assets/skills/comet/reference/comet-yaml-fields.md +1 -1
  6. package/assets/skills/comet/reference/context-recovery.md +3 -3
  7. package/assets/skills/comet/reference/decision-point.md +4 -5
  8. package/assets/skills/comet/reference/scripts.md +17 -47
  9. package/assets/skills/comet/reference/subagent-dispatch.md +8 -8
  10. package/assets/skills/comet/rules/comet-phase-guard.en.md +2 -2
  11. package/assets/skills/comet/rules/comet-phase-guard.md +2 -2
  12. package/assets/skills/comet/rules/comet-workflow-guard.en.md +4 -3
  13. package/assets/skills/comet/rules/comet-workflow-guard.md +4 -3
  14. package/assets/skills/comet/scripts/comet-archive.mjs +165 -2
  15. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +146 -8071
  16. package/assets/skills/comet/scripts/comet-guard.mjs +207 -2
  17. package/assets/skills/comet/scripts/comet-handoff.mjs +165 -2
  18. package/assets/skills/comet/scripts/comet-hook-guard.mjs +151 -2
  19. package/assets/skills/comet/scripts/comet-hook-router.mjs +155 -12083
  20. package/assets/skills/comet/scripts/comet-intent.mjs +10 -2
  21. package/assets/skills/comet/scripts/comet-resume-probe.mjs +148 -2
  22. package/assets/skills/comet/scripts/comet-runtime.mjs +286 -19192
  23. package/assets/skills/comet/scripts/comet-state.mjs +164 -2
  24. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +149 -2
  25. package/assets/skills/comet-archive/SKILL.md +1 -1
  26. package/assets/skills/comet-build/SKILL.md +13 -14
  27. package/assets/skills/comet-classic/SKILL.md +9 -9
  28. package/assets/skills/comet-design/SKILL.md +4 -4
  29. package/assets/skills/comet-hotfix/SKILL.md +2 -2
  30. package/assets/skills/comet-native/SKILL.md +35 -22
  31. package/assets/skills/comet-native/reference/artifacts.md +0 -7
  32. package/assets/skills/comet-native/reference/clarification.md +1 -1
  33. package/assets/skills/comet-native/reference/commands.md +69 -57
  34. package/assets/skills/comet-native/reference/recovery.md +11 -1
  35. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +178 -0
  36. package/assets/skills/comet-native/scripts/comet-native-check.mjs +173 -0
  37. package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +179 -0
  38. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +207 -0
  39. package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +151 -0
  40. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +150 -2
  41. package/assets/skills/comet-native/scripts/comet-native-init.mjs +171 -0
  42. package/assets/skills/comet-native/scripts/comet-native-new.mjs +200 -0
  43. package/assets/skills/comet-native/scripts/comet-native-next.mjs +182 -0
  44. package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +179 -0
  45. package/assets/skills/comet-native/scripts/comet-native-root.mjs +185 -0
  46. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +229 -34143
  47. package/assets/skills/comet-native/scripts/comet-native-select.mjs +178 -0
  48. package/assets/skills/comet-native/scripts/comet-native-show.mjs +151 -0
  49. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +181 -0
  50. package/assets/skills/comet-native/scripts/comet-native-status.mjs +175 -0
  51. package/assets/skills/comet-tweak/SKILL.md +2 -2
  52. package/assets/skills/comet-verify/SKILL.md +3 -3
  53. package/assets/skills-zh/comet/SKILL.md +10 -12
  54. package/assets/skills-zh/comet/reference/classic-layout.md +2 -2
  55. package/assets/skills-zh/comet/reference/comet-yaml-fields.md +1 -1
  56. package/assets/skills-zh/comet/reference/context-recovery.md +3 -3
  57. package/assets/skills-zh/comet/reference/decision-point.md +4 -5
  58. package/assets/skills-zh/comet/reference/scripts.md +9 -39
  59. package/assets/skills-zh/comet/reference/subagent-dispatch.md +8 -8
  60. package/assets/skills-zh/comet-archive/SKILL.md +1 -1
  61. package/assets/skills-zh/comet-build/SKILL.md +13 -14
  62. package/assets/skills-zh/comet-classic/SKILL.md +7 -7
  63. package/assets/skills-zh/comet-design/SKILL.md +5 -5
  64. package/assets/skills-zh/comet-hotfix/SKILL.md +2 -2
  65. package/assets/skills-zh/comet-native/SKILL.md +35 -22
  66. package/assets/skills-zh/comet-native/reference/artifacts.md +0 -7
  67. package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
  68. package/assets/skills-zh/comet-native/reference/commands.md +69 -57
  69. package/assets/skills-zh/comet-native/reference/recovery.md +11 -1
  70. package/assets/skills-zh/comet-tweak/SKILL.md +2 -2
  71. package/assets/skills-zh/comet-verify/SKILL.md +3 -3
  72. package/bin/comet.js +5 -1
  73. package/bin/fast-runtime-router.js +82 -0
  74. package/dist/app/cli/index.js +57 -18
  75. package/dist/app/cli/index.js.map +1 -1
  76. package/dist/app/commands/classic.js +2 -2
  77. package/dist/app/commands/classic.js.map +1 -1
  78. package/dist/app/commands/dashboard.d.ts.map +1 -1
  79. package/dist/app/commands/dashboard.js +2 -1
  80. package/dist/app/commands/dashboard.js.map +1 -1
  81. package/dist/app/commands/doctor.d.ts.map +1 -1
  82. package/dist/app/commands/doctor.js +9 -3
  83. package/dist/app/commands/doctor.js.map +1 -1
  84. package/dist/app/commands/i18n.d.ts +1 -1
  85. package/dist/app/commands/i18n.d.ts.map +1 -1
  86. package/dist/app/commands/i18n.js +10 -0
  87. package/dist/app/commands/i18n.js.map +1 -1
  88. package/dist/app/commands/init.d.ts.map +1 -1
  89. package/dist/app/commands/init.js +9 -5
  90. package/dist/app/commands/init.js.map +1 -1
  91. package/dist/app/commands/uninstall.d.ts.map +1 -1
  92. package/dist/app/commands/uninstall.js +150 -8
  93. package/dist/app/commands/uninstall.js.map +1 -1
  94. package/dist/app/commands/update.d.ts +1 -0
  95. package/dist/app/commands/update.d.ts.map +1 -1
  96. package/dist/app/commands/update.js +166 -24
  97. package/dist/app/commands/update.js.map +1 -1
  98. package/dist/config/repository-layout.json +33 -6
  99. package/dist/domains/comet-classic/classic-archive-entry.js +1 -1
  100. package/dist/domains/comet-classic/classic-archive-entry.js.map +1 -1
  101. package/dist/domains/comet-classic/classic-branch-binding.d.ts.map +1 -1
  102. package/dist/domains/comet-classic/classic-branch-binding.js +8 -2
  103. package/dist/domains/comet-classic/classic-branch-binding.js.map +1 -1
  104. package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
  105. package/dist/domains/comet-classic/classic-current-change.js +6 -1
  106. package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
  107. package/dist/domains/comet-classic/classic-guard-entry.js +1 -1
  108. package/dist/domains/comet-classic/classic-guard-entry.js.map +1 -1
  109. package/dist/domains/comet-classic/classic-guard.js +1 -1
  110. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  111. package/dist/domains/comet-classic/classic-handoff-entry.js +1 -1
  112. package/dist/domains/comet-classic/classic-handoff-entry.js.map +1 -1
  113. package/dist/domains/comet-classic/classic-hook-guard-entry.js +1 -1
  114. package/dist/domains/comet-classic/classic-hook-guard-entry.js.map +1 -1
  115. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  116. package/dist/domains/comet-classic/classic-hook-guard.js +7 -4
  117. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  118. package/dist/domains/comet-classic/classic-intent-entry.js +1 -1
  119. package/dist/domains/comet-classic/classic-intent-entry.js.map +1 -1
  120. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
  121. package/dist/domains/comet-classic/classic-layout-initialization.js +18 -11
  122. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  123. package/dist/domains/comet-classic/classic-layout.d.ts +7 -4
  124. package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
  125. package/dist/domains/comet-classic/classic-layout.js +9 -9
  126. package/dist/domains/comet-classic/classic-layout.js.map +1 -1
  127. package/dist/domains/comet-classic/classic-resume-probe-entry.js +1 -1
  128. package/dist/domains/comet-classic/classic-resume-probe-entry.js.map +1 -1
  129. package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
  130. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  131. package/dist/domains/comet-classic/classic-root-command.js +159 -49
  132. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  133. package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
  134. package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
  135. package/dist/domains/comet-classic/classic-root-move.js +24 -121
  136. package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
  137. package/dist/domains/comet-classic/classic-script-entry.d.ts +2 -2
  138. package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
  139. package/dist/domains/comet-classic/classic-script-entry.js +4 -3
  140. package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
  141. package/dist/domains/comet-classic/classic-state-command.js +6 -6
  142. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  143. package/dist/domains/comet-classic/classic-state-entry.js +1 -1
  144. package/dist/domains/comet-classic/classic-state-entry.js.map +1 -1
  145. package/dist/domains/comet-classic/classic-validate-entry.js +1 -1
  146. package/dist/domains/comet-classic/classic-validate-entry.js.map +1 -1
  147. package/dist/domains/comet-entry/current-selection-repair.js +1 -1
  148. package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
  149. package/dist/domains/comet-entry/entry-reads.d.ts +17 -0
  150. package/dist/domains/comet-entry/entry-reads.d.ts.map +1 -0
  151. package/dist/domains/comet-entry/entry-reads.js +20 -0
  152. package/dist/domains/comet-entry/entry-reads.js.map +1 -0
  153. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  154. package/dist/domains/comet-entry/hook-router-entry.js +3 -1
  155. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  156. package/dist/domains/comet-entry/hook-router.d.ts +12 -2
  157. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  158. package/dist/domains/comet-entry/hook-router.js +48 -17
  159. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  160. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  161. package/dist/domains/comet-entry/init-workflow.js +7 -8
  162. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  163. package/dist/domains/comet-entry/resolve-entry.d.ts.map +1 -1
  164. package/dist/domains/comet-entry/resolve-entry.js +3 -4
  165. package/dist/domains/comet-entry/resolve-entry.js.map +1 -1
  166. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  167. package/dist/domains/comet-entry/resume-probe.js +16 -5
  168. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  169. package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
  170. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  171. package/dist/domains/comet-native/native-acceptance.js +5 -29
  172. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  173. package/dist/domains/comet-native/native-archive-command.d.ts +3 -0
  174. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -0
  175. package/dist/domains/comet-native/native-archive-command.js +49 -0
  176. package/dist/domains/comet-native/native-archive-command.js.map +1 -0
  177. package/dist/domains/comet-native/native-archive-entry.d.ts +2 -0
  178. package/dist/domains/comet-native/native-archive-entry.d.ts.map +1 -0
  179. package/dist/domains/comet-native/native-archive-entry.js +4 -0
  180. package/dist/domains/comet-native/native-archive-entry.js.map +1 -0
  181. package/dist/domains/comet-native/native-check-command.d.ts +3 -0
  182. package/dist/domains/comet-native/native-check-command.d.ts.map +1 -0
  183. package/dist/domains/comet-native/native-check-command.js +30 -0
  184. package/dist/domains/comet-native/native-check-command.js.map +1 -0
  185. package/dist/domains/comet-native/native-check-entry.d.ts +2 -0
  186. package/dist/domains/comet-native/native-check-entry.d.ts.map +1 -0
  187. package/dist/domains/comet-native/native-check-entry.js +4 -0
  188. package/dist/domains/comet-native/native-check-entry.js.map +1 -0
  189. package/dist/domains/comet-native/native-checkpoint-command.d.ts +3 -0
  190. package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -0
  191. package/dist/domains/comet-native/native-checkpoint-command.js +39 -0
  192. package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -0
  193. package/dist/domains/comet-native/native-checkpoint-entry.d.ts +2 -0
  194. package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +1 -0
  195. package/dist/domains/comet-native/native-checkpoint-entry.js +4 -0
  196. package/dist/domains/comet-native/native-checkpoint-entry.js.map +1 -0
  197. package/dist/domains/comet-native/native-cli-shared.d.ts +40 -0
  198. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -0
  199. package/dist/domains/comet-native/native-cli-shared.js +272 -0
  200. package/dist/domains/comet-native/native-cli-shared.js.map +1 -0
  201. package/dist/domains/comet-native/native-cli.d.ts +2 -5
  202. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  203. package/dist/domains/comet-native/native-cli.js +37 -1228
  204. package/dist/domains/comet-native/native-cli.js.map +1 -1
  205. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  206. package/dist/domains/comet-native/native-continuation.js +34 -5
  207. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  208. package/dist/domains/comet-native/native-doctor-command.d.ts +3 -0
  209. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -0
  210. package/dist/domains/comet-native/native-doctor-command.js +29 -0
  211. package/dist/domains/comet-native/native-doctor-command.js.map +1 -0
  212. package/dist/domains/comet-native/native-doctor-entry.d.ts +2 -0
  213. package/dist/domains/comet-native/native-doctor-entry.d.ts.map +1 -0
  214. package/dist/domains/comet-native/native-doctor-entry.js +4 -0
  215. package/dist/domains/comet-native/native-doctor-entry.js.map +1 -0
  216. package/dist/domains/comet-native/native-evidence-command.d.ts +3 -0
  217. package/dist/domains/comet-native/native-evidence-command.d.ts.map +1 -0
  218. package/dist/domains/comet-native/native-evidence-command.js +35 -0
  219. package/dist/domains/comet-native/native-evidence-command.js.map +1 -0
  220. package/dist/domains/comet-native/native-evidence-entry.d.ts +2 -0
  221. package/dist/domains/comet-native/native-evidence-entry.d.ts.map +1 -0
  222. package/dist/domains/comet-native/native-evidence-entry.js +4 -0
  223. package/dist/domains/comet-native/native-evidence-entry.js.map +1 -0
  224. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  225. package/dist/domains/comet-native/native-evidence-retention.js +5 -21
  226. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  227. package/dist/domains/comet-native/native-evidence-storage.d.ts +19 -14
  228. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  229. package/dist/domains/comet-native/native-evidence-storage.js +91 -46
  230. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  231. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  232. package/dist/domains/comet-native/native-findings.js +24 -4
  233. package/dist/domains/comet-native/native-findings.js.map +1 -1
  234. package/dist/domains/comet-native/native-hook-guard-command.d.ts +3 -0
  235. package/dist/domains/comet-native/native-hook-guard-command.d.ts.map +1 -0
  236. package/dist/domains/comet-native/native-hook-guard-command.js +32 -0
  237. package/dist/domains/comet-native/native-hook-guard-command.js.map +1 -0
  238. package/dist/domains/comet-native/native-hook-guard-entry.d.ts +2 -0
  239. package/dist/domains/comet-native/native-hook-guard-entry.d.ts.map +1 -0
  240. package/dist/domains/comet-native/native-hook-guard-entry.js +4 -0
  241. package/dist/domains/comet-native/native-hook-guard-entry.js.map +1 -0
  242. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  243. package/dist/domains/comet-native/native-hook-guard.js +7 -1
  244. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  245. package/dist/domains/comet-native/native-init-command.d.ts +3 -0
  246. package/dist/domains/comet-native/native-init-command.d.ts.map +1 -0
  247. package/dist/domains/comet-native/native-init-command.js +29 -0
  248. package/dist/domains/comet-native/native-init-command.js.map +1 -0
  249. package/dist/domains/comet-native/native-init-entry.d.ts +2 -0
  250. package/dist/domains/comet-native/native-init-entry.d.ts.map +1 -0
  251. package/dist/domains/comet-native/native-init-entry.js +4 -0
  252. package/dist/domains/comet-native/native-init-entry.js.map +1 -0
  253. package/dist/domains/comet-native/native-new-command.d.ts +3 -0
  254. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -0
  255. package/dist/domains/comet-native/native-new-command.js +35 -0
  256. package/dist/domains/comet-native/native-new-command.js.map +1 -0
  257. package/dist/domains/comet-native/native-new-entry.d.ts +2 -0
  258. package/dist/domains/comet-native/native-new-entry.d.ts.map +1 -0
  259. package/dist/domains/comet-native/native-new-entry.js +4 -0
  260. package/dist/domains/comet-native/native-new-entry.js.map +1 -0
  261. package/dist/domains/comet-native/native-next-command.d.ts +3 -0
  262. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -0
  263. package/dist/domains/comet-native/native-next-command.js +82 -0
  264. package/dist/domains/comet-native/native-next-command.js.map +1 -0
  265. package/dist/domains/comet-native/native-next-entry.d.ts +2 -0
  266. package/dist/domains/comet-native/native-next-entry.d.ts.map +1 -0
  267. package/dist/domains/comet-native/native-next-entry.js +4 -0
  268. package/dist/domains/comet-native/native-next-entry.js.map +1 -0
  269. package/dist/domains/comet-native/native-receipt-command.d.ts +3 -0
  270. package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -0
  271. package/dist/domains/comet-native/native-receipt-command.js +107 -0
  272. package/dist/domains/comet-native/native-receipt-command.js.map +1 -0
  273. package/dist/domains/comet-native/native-receipt-entry.d.ts +2 -0
  274. package/dist/domains/comet-native/native-receipt-entry.d.ts.map +1 -0
  275. package/dist/domains/comet-native/native-receipt-entry.js +4 -0
  276. package/dist/domains/comet-native/native-receipt-entry.js.map +1 -0
  277. package/dist/domains/comet-native/native-receipt-refresh.d.ts +86 -0
  278. package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -0
  279. package/dist/domains/comet-native/native-receipt-refresh.js +232 -0
  280. package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -0
  281. package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
  282. package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
  283. package/dist/domains/comet-native/native-repair-integration.js +12 -15
  284. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  285. package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
  286. package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
  287. package/dist/domains/comet-native/native-repair-runtime.js +3 -10
  288. package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
  289. package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
  290. package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
  291. package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
  292. package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
  293. package/dist/domains/comet-native/native-root-command.d.ts +3 -0
  294. package/dist/domains/comet-native/native-root-command.d.ts.map +1 -0
  295. package/dist/domains/comet-native/native-root-command.js +29 -0
  296. package/dist/domains/comet-native/native-root-command.js.map +1 -0
  297. package/dist/domains/comet-native/native-root-entry.d.ts +2 -0
  298. package/dist/domains/comet-native/native-root-entry.d.ts.map +1 -0
  299. package/dist/domains/comet-native/native-root-entry.js +4 -0
  300. package/dist/domains/comet-native/native-root-entry.js.map +1 -0
  301. package/dist/domains/comet-native/native-script-entry.d.ts +12 -0
  302. package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -0
  303. package/dist/domains/comet-native/native-script-entry.js +44 -0
  304. package/dist/domains/comet-native/native-script-entry.js.map +1 -0
  305. package/dist/domains/comet-native/native-select-command.d.ts +3 -0
  306. package/dist/domains/comet-native/native-select-command.d.ts.map +1 -0
  307. package/dist/domains/comet-native/native-select-command.js +15 -0
  308. package/dist/domains/comet-native/native-select-command.js.map +1 -0
  309. package/dist/domains/comet-native/native-select-entry.d.ts +2 -0
  310. package/dist/domains/comet-native/native-select-entry.d.ts.map +1 -0
  311. package/dist/domains/comet-native/native-select-entry.js +4 -0
  312. package/dist/domains/comet-native/native-select-entry.js.map +1 -0
  313. package/dist/domains/comet-native/native-show-command.d.ts +3 -0
  314. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -0
  315. package/dist/domains/comet-native/native-show-command.js +41 -0
  316. package/dist/domains/comet-native/native-show-command.js.map +1 -0
  317. package/dist/domains/comet-native/native-show-entry.d.ts +2 -0
  318. package/dist/domains/comet-native/native-show-entry.d.ts.map +1 -0
  319. package/dist/domains/comet-native/native-show-entry.js +4 -0
  320. package/dist/domains/comet-native/native-show-entry.js.map +1 -0
  321. package/dist/domains/comet-native/native-snapshot.d.ts +9 -0
  322. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  323. package/dist/domains/comet-native/native-snapshot.js +141 -45
  324. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  325. package/dist/domains/comet-native/native-spec-command.d.ts +3 -0
  326. package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -0
  327. package/dist/domains/comet-native/native-spec-command.js +34 -0
  328. package/dist/domains/comet-native/native-spec-command.js.map +1 -0
  329. package/dist/domains/comet-native/native-spec-entry.d.ts +2 -0
  330. package/dist/domains/comet-native/native-spec-entry.d.ts.map +1 -0
  331. package/dist/domains/comet-native/native-spec-entry.js +4 -0
  332. package/dist/domains/comet-native/native-spec-entry.js.map +1 -0
  333. package/dist/domains/comet-native/native-status-command.d.ts +3 -0
  334. package/dist/domains/comet-native/native-status-command.d.ts.map +1 -0
  335. package/dist/domains/comet-native/native-status-command.js +36 -0
  336. package/dist/domains/comet-native/native-status-command.js.map +1 -0
  337. package/dist/domains/comet-native/native-status-entry.d.ts +2 -0
  338. package/dist/domains/comet-native/native-status-entry.d.ts.map +1 -0
  339. package/dist/domains/comet-native/native-status-entry.js +4 -0
  340. package/dist/domains/comet-native/native-status-entry.js.map +1 -0
  341. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  342. package/dist/domains/comet-native/native-transition-evidence.js +0 -10
  343. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  344. package/dist/domains/comet-native/native-transitions.d.ts +4 -0
  345. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  346. package/dist/domains/comet-native/native-transitions.js +31 -35
  347. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  348. package/dist/domains/comet-native/native-types.d.ts +8 -6
  349. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  350. package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
  351. package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
  352. package/dist/domains/comet-native/native-verification-evidence.js +13 -301
  353. package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
  354. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +16 -138
  355. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  356. package/dist/domains/comet-native/native-verification-receipt-runtime.js +132 -770
  357. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  358. package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
  359. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
  360. package/dist/domains/comet-native/native-verification-receipt.js +19 -350
  361. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
  362. package/dist/domains/comet-native/native-verification-runtime.d.ts +28 -4
  363. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  364. package/dist/domains/comet-native/native-verification-runtime.js +101 -218
  365. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  366. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  367. package/dist/domains/dashboard/collector.js +53 -41
  368. package/dist/domains/dashboard/collector.js.map +1 -1
  369. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  370. package/dist/domains/dashboard/native-collector.js +13 -3
  371. package/dist/domains/dashboard/native-collector.js.map +1 -1
  372. package/dist/domains/dashboard/project-directory.d.ts +20 -0
  373. package/dist/domains/dashboard/project-directory.d.ts.map +1 -0
  374. package/dist/domains/dashboard/project-directory.js +87 -0
  375. package/dist/domains/dashboard/project-directory.js.map +1 -0
  376. package/dist/domains/dashboard/project-root.d.ts +8 -0
  377. package/dist/domains/dashboard/project-root.d.ts.map +1 -0
  378. package/dist/domains/dashboard/project-root.js +68 -0
  379. package/dist/domains/dashboard/project-root.js.map +1 -0
  380. package/dist/domains/dashboard/server.d.ts +1 -0
  381. package/dist/domains/dashboard/server.d.ts.map +1 -1
  382. package/dist/domains/dashboard/server.js +50 -10
  383. package/dist/domains/dashboard/server.js.map +1 -1
  384. package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-mNt_SS1l.js} +1 -1
  385. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-Bc5akVD6.js +36 -0
  386. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-C43zhVBe.js} +2 -2
  387. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-dToETarK.js} +2 -2
  388. package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +1 -0
  389. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-C0oO137R.js} +1 -1
  390. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CGms1fgI.js} +1 -1
  391. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-Bugl8v6f.js} +1 -1
  392. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-8ATNMlBG.js} +1 -1
  393. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-BNYjSSqU.js} +1 -1
  394. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-_nJAqSbe.js} +1 -1
  395. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-lyxYm5NX.js} +1 -1
  396. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-PUMVeWpd.js} +1 -1
  397. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +1 -0
  398. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +1 -0
  399. package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-DzMqjexn.js +1 -0
  400. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-B67ET0eq.js} +1 -1
  401. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-CQPMvRLK.js +4 -0
  402. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-BRpLrFHM.js +43 -0
  403. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-CPGWuGrE.js +10 -0
  404. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-D2wpX2iO.js} +2 -2
  405. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-D54mAbDu.js +24 -0
  406. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-ZGQDpSs_.js +24 -0
  407. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-C3qDo7sd.js} +2 -2
  408. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-B7hStPd9.js} +2 -2
  409. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-IqcLFbTK.js +292 -0
  410. package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-YrMZpzUu.js +106 -0
  411. package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +257 -0
  412. package/dist/domains/dashboard/web/assets/{index-QO0z6F4w.js → index-icxk8_BP.js} +1 -1
  413. package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +1 -0
  414. package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-CcIgGK_7.js +2 -0
  415. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-1x3rNjGP.js} +2 -2
  416. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-B2XiqMNP.js} +2 -2
  417. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-x46cGuo3.js} +2 -2
  418. package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-DFLqGZWl.js} +1 -1
  419. package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-g3J6BACc.js} +69 -69
  420. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-CTdeKmcX.js} +2 -2
  421. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-C_obwjIf.js} +2 -2
  422. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-B6Gnfz9M.js} +4 -4
  423. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-nX4PObnB.js} +2 -2
  424. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-QjDwwHgl.js} +2 -2
  425. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK-BEEe0j6B.js} +2 -2
  426. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CXfAaBgM.js +1 -0
  427. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +1 -0
  428. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-BOzX2EnD.js} +2 -2
  429. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-C40vhXRq.js} +2 -2
  430. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-B1rm89JH.js} +2 -2
  431. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-BlMr59qK.js} +2 -2
  432. package/dist/domains/dashboard/web/index.html +2 -2
  433. package/dist/domains/integrations/openspec.d.ts +1 -0
  434. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  435. package/dist/domains/integrations/openspec.js +6 -0
  436. package/dist/domains/integrations/openspec.js.map +1 -1
  437. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  438. package/dist/domains/skill/platform-install.js +4 -6
  439. package/dist/domains/skill/platform-install.js.map +1 -1
  440. package/dist/domains/skill/uninstall.d.ts +6 -2
  441. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  442. package/dist/domains/skill/uninstall.js +128 -19
  443. package/dist/domains/skill/uninstall.js.map +1 -1
  444. package/dist/domains/workflow-contract/project-config.d.ts +1 -0
  445. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  446. package/dist/domains/workflow-contract/project-config.js +45 -1
  447. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  448. package/dist/platform/install/detect.d.ts +1 -0
  449. package/dist/platform/install/detect.d.ts.map +1 -1
  450. package/dist/platform/install/detect.js +2 -0
  451. package/dist/platform/install/detect.js.map +1 -1
  452. package/dist/platform/process/hook-read-cache.d.ts +45 -0
  453. package/dist/platform/process/hook-read-cache.d.ts.map +1 -0
  454. package/dist/platform/process/hook-read-cache.js +102 -0
  455. package/dist/platform/process/hook-read-cache.js.map +1 -0
  456. package/dist/platform/version/version.d.ts.map +1 -1
  457. package/dist/platform/version/version.js +9 -2
  458. package/dist/platform/version/version.js.map +1 -1
  459. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +2 -0
  460. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -0
  461. package/eval/local/tasks/comet-native-workflow/instruction.md +5 -17
  462. package/eval/local/tasks/comet-native-workflow/task.toml +4 -2
  463. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +227 -300
  464. package/eval/local/tests/conftest.py +0 -193
  465. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +107 -180
  466. package/eval/local/tests/scaffold/test_tasks.py +6 -9
  467. package/eval/local/tests/scaffold/test_utils.py +4 -7
  468. package/eval/scaffold/shell/docker.sh +2 -95
  469. package/package.json +7 -3
  470. package/dist/domains/comet-native/native-controller-trust.d.ts +0 -21
  471. package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
  472. package/dist/domains/comet-native/native-controller-trust.js +0 -140
  473. package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
  474. package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
  475. package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
  476. package/dist/domains/comet-native/native-independent-review.js +0 -134
  477. package/dist/domains/comet-native/native-independent-review.js.map +0 -1
  478. package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
  479. package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
  480. package/dist/domains/comet-native/native-review-contract.js +0 -6
  481. package/dist/domains/comet-native/native-review-contract.js.map +0 -1
  482. package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
  483. package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
  484. package/dist/domains/comet-native/native-review-identity.js +0 -209
  485. package/dist/domains/comet-native/native-review-identity.js.map +0 -1
  486. package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
  487. package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
  488. package/dist/domains/comet-native/native-review-signer.js +0 -125
  489. package/dist/domains/comet-native/native-review-signer.js.map +0 -1
  490. package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
  491. package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
  492. package/dist/domains/comet-native/native-review-trust.js +0 -176
  493. package/dist/domains/comet-native/native-review-trust.js.map +0 -1
  494. package/dist/domains/dashboard/web/assets/_commonjsHelpers-CqkleIqs.js +0 -1
  495. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-CjVHPivo.js +0 -36
  496. package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
  497. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
  498. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
  499. package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-CZk37fGn.js +0 -1
  500. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-D5BQ0eqN.js +0 -4
  501. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-33mXstha.js +0 -43
  502. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-BWHCMFvD.js +0 -10
  503. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-BBlsg7jG.js +0 -24
  504. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-CsaFSpHi.js +0 -24
  505. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-D1SQ56fl.js +0 -292
  506. package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-D4oDMS5x.js +0 -106
  507. package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
  508. package/dist/domains/dashboard/web/assets/index-Msce_H_q.js +0 -24
  509. package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-BeICn98s.js +0 -2
  510. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CcFBc6qh.js +0 -1
  511. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
  512. package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
  513. package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
  514. package/eval/scaffold/shell/native-review-verifier-daemon.mjs +0 -178
@@ -63,7 +63,7 @@ git rev-parse HEAD
63
63
 
64
64
  Write the plan to file, then return the file path.
65
65
 
66
- **Execute subagent**: Use the current platform's subagent dispatch mechanism to send the above task.
66
+ **Execute subagent**: Dispatch the above task to a subagent.
67
67
 
68
68
  After the subagent completes:
69
69
  - If a valid file path is returned and the file exists, record it as the plan
@@ -79,9 +79,9 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
79
79
 
80
80
  No manual phase update needed — guard auto-transitions when exit conditions are met.
81
81
 
82
- Check current platform capabilities before presenting the joint decision: verify whether `using-git-worktrees` is available, whether a real background subagent/Task/multi-agent dispatcher exists, and whether the repository can safely create a branch. Show only isolation and execution options that are currently executable. If a field has only one valid value, explain why and apply it without manufacturing another pause.
82
+ When presenting the joint decision, provide every workspace-isolation and execution choice supported by this workflow. Do not preflight, infer, or filter whether another Skill, branch, worktree, subagent dispatch, or model selection can be used. After the user chooses, run the corresponding action; if it fails, stop and report the original error. If a field has only one workflow-valid value, explain why and apply it without manufacturing another pause.
83
83
 
84
- After recording the plan, provide exactly **one joint decision point** that collects whether to continue now, available workspace isolation, available execution method, TDD mode, and code review mode. The branch name must be confirmed in the same Step 2 joint decision when `branch` is selected. Do not ask continue/pause first and then create another configuration or naming blocker.
84
+ After recording the plan, provide exactly **one joint decision point** that collects whether to continue now, workspace isolation, execution method, TDD mode, and code review mode. The branch name must be confirmed in the same Step 2 joint decision when `branch` is selected. Do not ask continue/pause first and then create another configuration or naming blocker.
85
85
 
86
86
  | Option | Behavior | Description |
87
87
  |--------|----------|-------------|
@@ -141,7 +141,7 @@ The plan is on the current branch. These settings are all part of the single Ste
141
141
  - Task count ≤ 2 and no cross-module dependencies → Recommend B
142
142
  - From hotfix path → Recommend B
143
143
 
144
- These tables are part of the Step 2 joint decision and do not create another pause. First remove options that capability preflight found unavailable. When multiple valid options remain, do not choose `current`, `branch`, or `worktree`, execution method, TDD mode, or review mode from recommendations. Recommendations explain a preference; they never replace user confirmation.
144
+ These tables are part of the Step 2 joint decision and do not create another pause. Always show the isolation and execution options supported by this workflow; do not remove an option by predicting that an action will fail. When multiple valid options remain, do not choose `current`, `branch`, or `worktree`, execution method, TDD mode, or review mode from recommendations. Recommendations explain a preference; they never replace user confirmation.
145
145
 
146
146
  After user selection, update `isolation`, execution method, TDD mode, and code review mode fields:
147
147
 
@@ -150,8 +150,7 @@ comet state set <name> isolation <current|branch|worktree>
150
150
  ```
151
151
 
152
152
  - If the user chooses `executing-plans`: run `comet state set <name> subagent_dispatch null`, then run `comet state set <name> build_mode executing-plans`
153
- - If the user chooses `subagent-driven-development`: first confirm the current platform has real background subagent / Task / multi-agent dispatch capability; after confirming, run `comet state set <name> subagent_dispatch confirmed`, then run `comet state set <name> build_mode subagent-driven-development`
154
- - If real background dispatch capability cannot be confirmed, do not show or write `build_mode: subagent-driven-development`. If recovered state already records that mode but capability is unavailable, return to the same Step 2 joint decision with only executable modes; do not create a separate "switch to executing-plans" pause
153
+ - If the user chooses `subagent-driven-development`: run `comet state set <name> subagent_dispatch confirmed` to record the selected subagent execution, then run `comet state set <name> build_mode subagent-driven-development`
155
154
 
156
155
  **TDD Mode**:
157
156
 
@@ -174,7 +173,7 @@ Run `comet state set <name> review_mode <off|standard|thorough>`
174
173
 
175
174
  `isolation` is a script-enforced hard constraint. Full workflow init may temporarily leave it as `null`, but only before this step. If it remains `null`, both the `build → verify` guard and `comet state transition build-complete` will fail. Full workflow allows `current`, `branch`, or `worktree`, but `current` must be written only after the user explicitly selects it in Step 2; never make it a silent default.
176
175
 
177
- `subagent_dispatch` is a script-enforced hard constraint. `build_mode: subagent-driven-development` requires `subagent_dispatch: confirmed` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail.
176
+ `subagent_dispatch` is a script-enforced hard constraint that records the user's selected subagent execution. `build_mode: subagent-driven-development` requires `subagent_dispatch: confirmed` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail; it is not a capability check.
178
177
 
179
178
  `tdd_mode` is a script-enforced hard constraint. Full workflow must have `tdd_mode` selected as `tdd` or `direct` before leaving the build phase, otherwise both `comet guard build --apply` and `comet state transition build-complete` will fail.
180
179
 
@@ -206,7 +205,7 @@ Without `direct_override: true`, `build_mode=direct` in full workflow is blocked
206
205
 
207
206
  Immediately after Step 2 confirms the branch name, run `git checkout -b <branch-name>`, then run `comet state set <name> isolation branch` to write the new branch to `bound_branch`. Continue on the new branch.
208
207
 
209
- - **worktree**: Must use the Skill tool to load the Superpowers `using-git-worktrees` skill to create isolated workspace. Do not bypass this skill with plain shell commands or native tools; if the skill is unavailable, stop the process and prompt to install or enable Superpowers skills.
208
+ - **worktree**: **Immediately execute:** Use the Skill tool to load the Superpowers `using-git-worktrees` skill to create an isolated workspace. Do not bypass this skill with plain shell commands or native tools. If loading it fails because it is unavailable, stop and report that error.
210
209
 
211
210
  After creating isolation, confirm plan file is accessible (naturally accessible with branch method; for worktree method, confirm plan has been committed). If the plan file has not been committed under worktree mode, commit it first before creating the worktree:
212
211
 
@@ -225,9 +224,9 @@ Do not begin source writes until this binding succeeds.
225
224
 
226
225
  **Execute plan**: Must handle execution according to the actual runtime of `build_mode`.
227
226
 
228
- - `build_mode: executing-plans`: **Immediately execute:** Use the Skill tool to load the Superpowers `executing-plans` skill. Skipping this step is prohibited. If the skill is unavailable, stop the process and prompt to install or enable the corresponding skill; do not substitute with normal conversation. After the skill loads, ARGUMENTS must include the same Language constraint as Step 1: `Language: Use the configured Comet artifact language from comet state get <name> language`. Execute according to plan.
229
- - `build_mode: subagent-driven-development`: The main session only coordinates and must not write implementation code directly. **Immediately execute:** Use the Skill tool to load the Superpowers `subagent-driven-development` skill. After the skill loads, read `comet/reference/subagent-dispatch.md` for Comet-specific extensions (real background dispatch, task isolation, checkoff verification, TDD constraints, continuous execution, context recovery) and apply them alongside the skill's workflow. If they conflict, the more specific Comet extensions take precedence.
230
- - If the execution preflight finds that background dispatch capability has disappeared, do not execute directly in the main window and do not create a new second decision. Return to the same Step 2 joint decision with the unavailable mode removed. After the user selects main-window execution there, run `comet state set <name> build_mode executing-plans`, then continue through that branch.
227
+ - `build_mode: executing-plans`: **Immediately execute:** Use the Skill tool to load the Superpowers `executing-plans` skill. Skipping this step is prohibited. If loading fails, stop and report the error; do not substitute with normal conversation. After the skill loads, ARGUMENTS must include the same Language constraint as Step 1: `Language: Use the configured Comet artifact language from comet state get <name> language`. Execute according to plan.
228
+ - `build_mode: subagent-driven-development`: The main session only coordinates and must not write implementation code directly. **Immediately execute:** Use the Skill tool to load the Superpowers `subagent-driven-development` skill. After the skill loads, read `comet/reference/subagent-dispatch.md` for Comet-specific extensions (subagent dispatch, task isolation, checkoff verification, TDD constraints, continuous execution, context recovery) and apply them alongside the skill's workflow. If they conflict, the more specific Comet extensions take precedence.
229
+ - If subagent dispatch fails, follow `comet/reference/subagent-dispatch.md` to record the current task as `BLOCKED` with the failure reason; the main session must not take over implementation.
231
230
 
232
231
  **TDD Mode Execution Constraints**:
233
232
 
@@ -247,7 +246,7 @@ Under `executing-plans`, the main session executes tasks directly (no isolated i
247
246
 
248
247
  Requirements (apply to `standard` and `thorough`):
249
248
  - the `requesting-code-review` skill must be loaded before `comet guard <change-name> build --apply`
250
- - if `requesting-code-review` is unavailable under `standard` or `thorough`, stop and ask the user to install/enable it and retry, or explicitly switch to `review_mode: off` with a recorded reason; never skip the gate or continue guard before that explicit switch
249
+ - if loading `requesting-code-review` fails under `standard` or `thorough`, stop and ask the user to resolve the error and retry, or explicitly switch to `review_mode: off` with a recorded reason; never skip the gate or continue guard before that explicit switch
251
250
  - CRITICAL review findings (security vulnerabilities, data loss risk, build/test failures) must be fixed first and must not be carried into verify
252
251
  - if non-CRITICAL review findings are accepted, record the acceptance reason and impact scope in tasks.md, the commit body, a verification report draft, or another durable artifact
253
252
 
@@ -264,8 +263,8 @@ When the initial spec is found incomplete during implementation, handle by scale
264
263
  | Scale | Trigger Conditions | Approach |
265
264
  |------|-------------------|----------|
266
265
  | Small | Missing acceptance scenarios, edge cases | Directly edit delta spec + design.md, append tasks.md tasks |
267
- | Medium | Interface changes, new components, data flow changes | **Must use the current platform's available user input/confirmation mechanism to pause and wait for the user to explicitly confirm**, then must use Skill tool to load the Superpowers `brainstorming` skill to update Design Doc + delta spec |
268
- | Large | Brand-new capability requirements | **Must use the current platform's available user input/confirmation mechanism to pause and wait for the user to explicitly confirm the split**; after user confirms, create independent change through `/comet-open` |
266
+ | Medium | Interface changes, new components, data flow changes | **Pause, present the choice, and wait for the user to explicitly confirm**, then must use Skill tool to load the Superpowers `brainstorming` skill to update Design Doc + delta spec |
267
+ | Large | Brand-new capability requirements | **Pause, present the split choice, and wait for the user to explicitly confirm**; after user confirms, create independent change through `/comet-open` |
269
268
 
270
269
  **50% Threshold Determination**: Using initial task count in tasks.md as baseline, if new tasks exceed half of that total, it's considered outside original plan scope, **must follow the `comet/reference/decision-point.md` protocol to pause and wait for the user to decide whether to split into a new change**.
271
270
 
@@ -30,10 +30,10 @@ Use the configured Comet artifact language as the output language for every Open
30
30
 
31
31
  **Step 0: Active Change Discovery and Intent Resolution**
32
32
 
33
- 1. First load script locations through `comet/reference/scripts.md` and ensure `$COMET_INTENT` is available.
33
+ 1. First follow `comet/reference/scripts.md` and run the public `comet` CLI command directly.
34
34
  2. Run `comet classic openspec -- list --json` to collect active changes.
35
35
  3. Fill a `CometIntentFrame` from the user request, active change list, and necessary repository state.
36
- 4. Prefer `node "$COMET_INTENT" route --stdin` to pass the frame JSON and get the runtime-normalized route. `CometIntentFrame + runtime scorer` is the source of truth; this prose is only for intent recognition slot extraction.
36
+ 4. Prefer `comet classic intent route --stdin` to pass the frame JSON and get the runtime-normalized route. `CometIntentFrame + runtime scorer` is the source of truth; this prose is only for intent recognition slot extraction.
37
37
  5. Handle the runtime route:
38
38
  - `hotfix` → invoke `/comet-hotfix`
39
39
  - `tweak` → invoke `/comet-tweak`
@@ -55,7 +55,7 @@ When multiple active changes exist and the user has not selected one, do not bin
55
55
  When the user did not explicitly invoke `/comet-classic`, but this repository may already have an active Comet change, run the read-only probe before starting work that may need code changes or investigation:
56
56
 
57
57
  ```bash
58
- node "$COMET_RESUME_PROBE" probe --stdin
58
+ comet resume-probe . --stdin --json
59
59
  ```
60
60
 
61
61
  The probe only reads repository state. Follow the returned action:
@@ -184,7 +184,7 @@ A single `/comet-classic` invocation starts from the detected phase and advances
184
184
 
185
185
  Flow chain: open → design → build → verify → archive
186
186
 
187
- **Continuous execution requirement**: starting from the detected phase, the agent automatically continues through all later phases. But **auto-advancing only applies at transition points without user decisions**. When encountering user decision points, **must use the current platform's available user input/confirmation mechanism to pause and wait for the user's explicit response**. Must not use recommendation rules, defaults, or historical preferences to substitute for user confirmation, and must not just output a text prompt and then continue executing.
187
+ **Continuous execution requirement**: starting from the detected phase, the agent automatically continues through all later phases. But **auto-advancing only applies at transition points without user decisions**. When encountering user decision points, pause, present clear options, and wait for the user's explicit response. Must not use recommendation rules, defaults, or historical preferences to substitute for user confirmation, and must not just output a text prompt and then continue executing.
188
188
 
189
189
  **Distinguish phase advancement vs automatic handoff**: each sub-skill runs phase guard `--apply` before exit to advance the `.comet.yaml` `phase` field. This step **always happens** and is not controlled by `auto_transition`. After that, the sub-skill runs `comet state next <name>` to resolve the next action: when `auto_transition` is not `false`, output is `NEXT: auto` (auto-invoke next skill); when `auto_transition` is `false`, output is `NEXT: manual` (do not invoke next skill; return control with `HINT`). `NEXT: manual` is not a user decision point and must not ask whether to continue. Therefore `auto_transition` **only controls next skill invocation, not phase advancement**. Regardless of `auto_transition`, genuine user decision points below remain blocking.
190
190
 
@@ -194,7 +194,7 @@ Nodes requiring user participation (pause only at these nodes):
194
194
  1. Workflow target selection: multiple active changes, continue an existing change versus create a new one, or choose which completed batch item starts first
195
195
  2. Open-phase final proposal/design/tasks review, including the change name and scope; clear requests have no pre-artifact summary/name confirmation
196
196
  3. Confirm the design approach during brainstorming
197
- 4. One joint build decision: plan-ready pause or all available workflow settings (workspace isolation + execution method + TDD mode + code review mode, plus branch name when branch is selected)
197
+ 4. One joint build decision: plan-ready pause or all workflow settings (workspace isolation + execution method + TDD mode + code review mode, plus branch name when branch is selected)
198
198
  5. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or continue/stop after the 4th failure; the first 3 clearly repairable failures close automatically
199
199
  6. Archive phase final confirmation before running the archive script
200
200
  7. Choose finishing-branch handling after exact archive changes are committed
@@ -202,13 +202,13 @@ Nodes requiring user participation (pause only at these nodes):
202
202
  9. Build phase scope expansion requiring redesign or new change split
203
203
  10. Open phase large PRD split confirmation
204
204
 
205
- Agents should not skip these decision points; other unambiguous phase transitions must proceed automatically, must not exit midway. At decision points, **must not skip user confirmation or choose automatically — must explicitly obtain the user's choice through the current platform's available user input/confirmation mechanism before continuing**.
205
+ Agents should not skip these decision points; other unambiguous phase transitions must proceed automatically, must not exit midway. At decision points, **must not skip user confirmation or choose automatically — ask clear options and wait for the user's explicit choice before continuing**.
206
206
 
207
207
  **Red Flags** — when these thoughts appear, STOP and check:
208
208
 
209
209
  | Agent Thought | Actual Risk |
210
210
  |--------------|-------------|
211
- | "The user would probably agree with this approach" | Cannot decide for the user — use the current platform's user input/confirmation mechanism |
211
+ | "The user would probably agree with this approach" | Cannot decide for the user — present the choice and wait for the reply |
212
212
  | "This is a small change, confirmation isn't needed" | Decision points have no size exception — blocking points must wait |
213
213
  | "The user chose A last time, so A again" | Historical preference cannot substitute for current confirmation |
214
214
  | "I explained the plan and the user didn't object" | No objection ≠ consent — must use tool to get explicit choice |
@@ -283,9 +283,9 @@ See `comet/reference/decision-point.md` for the complete user decision point pro
283
283
 
284
284
  See `comet/reference/debug-gate.md` for the complete debug gate protocol.
285
285
 
286
- ### Script Location
286
+ ### Public CLI
287
287
 
288
- Use the stable `comet` CLI for workflow state, guards, handoff, and archive. Locate internal launchers through `comet/reference/scripts.md` only for intent/resume probes that do not yet have a public subcommand. Key entry points:
288
+ Follow `comet/reference/scripts.md` once per session and use only the public `comet` CLI. Do not search for or invoke internal bundles. Key entry points:
289
289
 
290
290
  ```bash
291
291
  comet guard <change-name> <phase> --apply # phase guard + state update
@@ -148,7 +148,7 @@ Only after the user explicitly confirms, proceed to Step 2. If the user requests
148
148
 
149
149
  After the user confirms the design proposal, before creating the Design Doc, create or update the incrementally maintained checkpoint file and finalize it as the confirmed design summary:
150
150
 
151
- Use the current platform's file API to ensure `<classic-change-dir>/.comet/handoff/` exists; do not rely on a POSIX-only directory command.
151
+ Use the file tool to ensure `<classic-change-dir>/.comet/handoff/` exists; do not rely on a POSIX-only directory command.
152
152
 
153
153
  `<classic-change-dir>/.comet/handoff/brainstorm-summary.md` structure:
154
154
 
@@ -224,9 +224,9 @@ If there are no delta spec changes, skip the handoff regeneration step. The stat
224
224
 
225
225
  Consider active compaction only **after the Design Doc and state evidence are persisted** and before Build. First confirm `design_doc`, the latest handoff, `handoff_hash`, and the design guard are durable so recovery never depends on an unwritten design judgment.
226
226
 
227
- - If the host exposes a programmatically callable native compaction mechanism and the context window is under pressure, invoke it once and include the change, next step, Design Doc, and handoff files in the resume prompt
228
- - If only the user can trigger compaction, give one non-blocking suggestion and continue; it **must not block when programmatic compaction is unavailable** and must not create another confirmation point
229
- - Never fake host compaction with a shell command or an agent summary
227
+ - When a programmatically callable compaction mechanism is present and the context window is under pressure, invoke it once and include the change, next step, Design Doc, and handoff files in the resume prompt
228
+ - If compaction requires user action, give one non-blocking suggestion and continue; it **must not block** and must not create another confirmation point
229
+ - Never fake compaction with a shell command or an agent summary
230
230
 
231
231
  ## Exit Conditions
232
232
 
@@ -26,7 +26,7 @@ Streamlined OpenSpec artifacts must use the configured Comet artifact language.
26
26
 
27
27
  Execution chain: open → build → root cause check → verify → archive. Hotfix provides default decisions for each phase: streamlined open, direct build, root cause confirmation, scale-based verification, and final archive confirmation after verification passes.
28
28
 
29
- Before starting, locate Comet scripts via `comet/reference/scripts.md`. When resuming from any entry point, first use `comet/reference/context-recovery.md` to confirm phase/workflow.
29
+ Before starting, use `comet/reference/scripts.md` to run the public Comet CLI command. When resuming from any entry point, first use `comet/reference/context-recovery.md` to check phase/workflow.
30
30
 
31
31
  When resuming an existing hotfix change, the first state operation must be `comet state select <change-name>`. For a new change, run the command immediately after `.comet.yaml` initialization and before source writes.
32
32
 
@@ -161,7 +161,7 @@ Exception: when `.comet.yaml` has `auto_transition: false`, end the current invo
161
161
 
162
162
  The following genuine user decisions still pause:
163
163
 
164
- 1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Must use the current platform's available user input/confirmation mechanism to pause and wait for the user to explicitly choose**: continue the hotfix flow, or upgrade to the full `/comet-classic` workflow
164
+ 1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Pause, present the choices, and wait for the user to explicitly choose**: continue the hotfix flow, or upgrade to the full `/comet-classic` workflow
165
165
  2. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or strategy after the automatic repair limit; the first 3 clearly repairable failures close automatically
166
166
  3. Final archive confirmation and the branch-handling decision after the archive commit
167
167
 
@@ -7,15 +7,6 @@ description: Use when the user explicitly invokes /comet-native, asks to start o
7
7
 
8
8
  Native stores requirements, complete target specifications, state, and evidence. You understand, implement, and verify; the Runtime owns state, boundaries, and recovery.
9
9
 
10
- ## Progressive loading
11
-
12
- Start with this file only. Read one reference when the corresponding task appears:
13
-
14
- - If Shape contains unresolved user-visible behavior, read the [clarification reference](reference/clarification.md).
15
- - If you need advanced options, receipts, partial scope, or an external-role handoff command, read the [command reference](reference/commands.md).
16
- - If you need to edit the brief, specifications, or verification report, read the [artifact reference](reference/artifacts.md).
17
- - If interruption, stale evidence, a repair stop, conflict, lock, or migration occurs, read the [recovery reference](reference/recovery.md).
18
-
19
10
  ## Core rules
20
11
 
21
12
  Read these values from `.comet/config.yaml`:
@@ -28,15 +19,27 @@ Config, selection, change state, and formal artifacts on disk take precedence ov
28
19
 
29
20
  The Native main workflow does not depend on any external Skill.
30
21
 
31
- Do not receive signing private keys or impersonate an external approval role. When an external action is missing, follow the Runtime continuation, wait, and hand off the required command.
22
+ ## CLI bootstrap
23
+
24
+ The Native Skill uses only the public `comet native <cmd>` CLI on PATH. Packaged command bundles are internal installation and Runtime assets; the Skill does not search for or invoke them directly. If a command returns `command not found`, `executable not found`, or `ENOENT`, stop and explain that the Comet CLI installation is incomplete. Do not search for Skill files, enumerate platform directories, or invoke an internal bundle directly.
25
+
26
+ Common commands:
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]
33
+ comet native next <change-name> --summary <text> [--confirmed]
34
+ comet native archive <change-name> --dry-run
35
+ ```
32
36
 
33
37
  ## Start or resume
34
38
 
35
39
  1. Run `comet native status` to identify the current change and phase.
36
- 2. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run `status <change-name> --details`.
40
+ 2. Run `comet native show <change-name>` for the target. In Verify, Archive, or Build after a failure, also run the status command with `--details`.
37
41
  3. When more acceptance items are needed, follow `acceptancePage.nextCursor`. If findings are truncated, handle the returned findings and then read details again.
38
42
  4. After confirming the target, run `comet native select <change-name>`.
39
- 5. Read only the formal artifacts, implementation, tests, and project rules needed by the current phase.
40
43
 
41
44
  If multiple reasonable candidates remain, ask the user to select one. Create a change only after confirming that no matching active change exists:
42
45
 
@@ -47,11 +50,20 @@ comet native new <change-name> \
47
50
 
48
51
  Use only the Native artifact root selected by project configuration.
49
52
 
53
+ ## On-demand loading
54
+
55
+ After confirming the current change and phase, read one corresponding reference on demand:
56
+
57
+ - When entering Shape, you must first read and execute the [clarification reference](reference/clarification.md). Do not skip it because “the requirements look clear.” Do not modify project implementation or advance to Build until shared understanding is confirmed.
58
+ - If you need advanced options, receipts, or partial-scope commands, read the [command reference](reference/commands.md).
59
+ - If you need to edit the brief, specifications, or verification report, read the [artifact reference](reference/artifacts.md).
60
+ - If interruption, stale evidence, a repair stop, conflict, lock, or migration occurs, read the [recovery reference](reference/recovery.md).
61
+
50
62
  ## Shape
51
63
 
52
64
  First investigate facts available from the repository, tools, and runtime environment. Ask the user only when different choices would materially change user-visible results and the existing requirements do not resolve the choice reliably. You own implementation choices.
53
65
 
54
- When behavior is unresolved, read the clarification reference and follow `clarification_mode`. After every user answer, immediately update Decisions, the brief, and the complete target specifications in the same change. Keep unresolved items `[blocking]`; do not modify project implementation or advance while a blocker remains.
66
+ Follow the clarification reference according to `clarification_mode`. Even when the initial assessment finds no unresolved behavior, complete its information classification and silent-assumption check. After every user answer, immediately update Decisions, the brief, and the complete target specifications in the same change. Keep unresolved items `[blocking]`; do not modify project implementation or advance while a blocker remains.
55
67
 
56
68
  After all user decisions are resolved, check again for silent assumptions. Give the user a shared-understanding summary covering the goal, scope, key decisions, acceptance criteria, and non-goals. Only after explicit confirmation may you remove the final blocker and advance:
57
69
 
@@ -65,14 +77,15 @@ If the brief or specifications change confirmed behavior, obtain confirmation ag
65
77
 
66
78
  Implement the simplest reliable solution that satisfies the brief and complete target specifications. Work may proceed in batches. Long tasks may use a checkpoint for recovery context, but a checkpoint is not completion evidence.
67
79
 
68
- When requirements change, update the formal artifacts first. If a new user decision appears, return to the Shape clarification and confirmation boundary.
80
+ When requirements change, update the formal artifacts first. If a new user decision appears, stay in Build but repeat the Shape clarification and confirmation boundary: save a `[blocking]` item, pause implementation, and ask the user. After confirmation, update Decisions, the brief, and the complete target specifications, then remove the blocker. When leaving Build, run the command returned by the Runtime and pass `--confirmed`.
69
81
 
70
82
  After the candidate implementation is complete, review it against the complete specifications and every acceptance item for omissions, then advance with real project artifacts:
71
83
 
72
84
  ```text
73
85
  comet native next <change-name> \
74
86
  --summary <summary> \
75
- --artifact <project-path>
87
+ --artifact <project-path> \
88
+ [--confirmed]
76
89
  ```
77
90
 
78
91
  If no code changed or the Runtime cannot prove complete scope, read the command reference. Never describe unknown or incomplete scope as complete.
@@ -81,23 +94,23 @@ If no code changed or the Runtime cannot prove complete scope, read the command
81
94
 
82
95
  After entering Build, converge through this loop:
83
96
 
84
- 1. Run `status <change-name> --details` and read the currently required acceptance pages. After a Verify failure, prioritize failed or missing acceptance items and failed checks.
97
+ 1. Run `comet native status <change-name> --details` and read the currently required acceptance pages. After a Verify failure, prioritize failed or missing acceptance items and failed checks.
85
98
  2. Complete one related batch of real repairs. You may write a checkpoint before interruption, but a checkpoint is not completion evidence.
86
99
  3. When a candidate implementation exists, reread the brief, complete specifications, and every acceptance item, then perform one complete review.
87
100
  4. Run real validation and submit the Verify result.
88
101
  5. `fail` returns to Build and repeats from step 1 without running Archive; only `pass` enters Archive.
89
102
 
90
- The loop ends only at `done`, `await-user`, `blocked`, or an explicit caller stop point. One Agent turn, one checkpoint, or the Agent saying “complete” is not a terminal state. The Agent finds and repairs gaps; the Runtime decides whether completion has been proven.
103
+ `blocked` pauses the normal Build → Verify loop and enters a recovery branch. After handling the findings, resume from step 1 according to the new continuation. End the current work only at `done`, `await-user`, or an explicit caller stop point. One Agent turn, one checkpoint, one `blocked` result, or the Agent saying “complete” is not a terminal state. The Agent finds and repairs gaps; the Runtime decides whether completion has been proven.
91
104
 
92
105
  ## Verify
93
106
 
94
107
  Run real validation based on the acceptance items, complete target specifications, and change risk. Record actual results in `verification.md` and the acceptance evidence. A check that did not run or failed cannot be reported as passed.
95
108
 
96
- Use acceptance IDs and receipts returned by the Runtime. Read the artifact and command references when you need to generate the evidence block, record an automated or manual receipt, request a waiver, or hand off independent review. The current Agent does not perform external signing.
109
+ Use acceptance IDs and receipts returned by the Runtime. Read the artifact and command references when you need to generate the evidence block or record an automated or manual receipt.
97
110
 
98
- Submit `pass` only when the Runtime accepts the complete, fresh acceptance matrix, required checks, and independent review. Reverify after relevant implementation, specification, report, or evidence changes.
111
+ Submit `pass` only when the Runtime accepts the complete, fresh acceptance matrix and required checks. Reverify after relevant implementation, specification, report, or evidence changes.
99
112
 
100
- `fail` returns to Build. Fix the failed or missing acceptance items and failed checks reported by the Runtime before verifying again; another `next` call is not itself a repair. When the Runtime reaches its repeated-gap stop condition or the `native.max_verify_failures` budget, stop and wait for a user decision.
113
+ `fail` returns to Build. Fix the failed or missing acceptance items and failed checks reported by the Runtime before verifying again; another `next` call is not itself a repair. For `repair-stagnation-stop`, follow the recovery reference to form a new hypothesis and use the Runtime-provided override. Wait for the user only when the continuation requires `repair-continuation-decision`.
101
114
 
102
115
  An intermediate Verify failure never runs Archive or triggers archive confirmation. Continue Build → Verify until pass, a Runtime block, or a required user decision.
103
116
 
@@ -121,8 +134,8 @@ Do not reuse an old preflight. If facts drift or a canonical conflict or unfinis
121
134
  Shape, Build, and Verify transitions return `next: auto | manual` together with `continuation.disposition: continue | await-user | blocked | done`, required inputs, and the next action. Archive does not advance through `next`; a successful archive returns `done`. After every transition, act on that Runtime continuation:
122
135
 
123
136
  - `continue`: reread the phase and currently required artifacts, then continue;
124
- - `await-user`: wait for input that genuinely belongs to the user or an external role;
125
- - `blocked`: handle the findings and read the recovery reference when needed;
137
+ - `await-user`: wait for a decision or missing input that genuinely requires the user;
138
+ - `blocked`: pause the normal loop, handle the findings, and read the recovery reference when needed; then resume according to the new continuation rather than ending the task because it was `blocked`;
126
139
  - `done`: the change is complete.
127
140
 
128
141
  `next: auto` means only that the current transition succeeded; later work has not run automatically. If the caller explicitly requests a stop after a transition, update the formal artifacts, run the one allowed transition, make no tool calls after the transition succeeds, then output the agreed marker and end the turn, even when the continuation is `continue`.
@@ -124,18 +124,11 @@ Place the command output unchanged under `# Acceptance evidence`. The basic inpu
124
124
  "status": "failed",
125
125
  "evidence_refs": [],
126
126
  "skipped_reason": "actual failure or incomplete reason"
127
- },
128
- {
129
- "acceptance_id": "acceptance-<sha256>",
130
- "status": "waived",
131
- "evidence_refs": [],
132
- "waiver_ref": "runtime/evidence/waivers/<sha256>.json"
133
127
  }
134
128
  ]
135
129
  ```
136
130
 
137
131
  - `passed` references a currently valid typed receipt.
138
132
  - `failed` states the actual failure or skipped reason.
139
- - `waived` references the waiver returned by an external signer.
140
133
 
141
134
  Do not hand-format the machine block, reuse an evidence ref from another change, or report failed, skipped, or blocked results as passed.
@@ -1,6 +1,6 @@
1
1
  # Native Clarification Reference
2
2
 
3
- Read this file only when Shape contains unresolved user-visible behavior.
3
+ You must read this file after entering Shape. Do not modify project implementation or advance to Build until problem classification, the silent-assumption check, and shared-understanding confirmation are complete.
4
4
 
5
5
  ## Whether to ask
6
6
 
@@ -1,35 +1,83 @@
1
1
  # Native Command Reference
2
2
 
3
- Read this file only when you need options not listed by the main Skill, receipts, partial scope, an external-role handoff, or recovery commands.
3
+ Read this file only when you need options not listed by the main Skill, receipts, partial scope, or recovery commands.
4
4
 
5
5
  ## Project and change
6
6
 
7
+ Determine the current intent first; do not execute this section from top to bottom. Use read-only commands to establish facts, and run a write command only when its stated condition is met. After any write command, immediately reread `status <change-name>` and use the returned phase and continuation to decide what comes next.
8
+
9
+ ### Enable Native for the first time
10
+
7
11
  ```text
8
12
  comet native init [--root <artifact-root>] [--language en|zh-CN]
13
+ ```
14
+
15
+ Use this only when the project has not enabled Native yet or when Native directories and language configuration need to be completed. It creates the required directories and writes `.comet/config.yaml`. Existing configuration keeps its current artifact root but may update the language. `init` does not migrate an existing artifact root; the command fails when an explicit `--root` conflicts with existing configuration.
16
+
17
+ Afterward, run `root show` to confirm the effective location. Do not use `init` as a resume command when a change already exists.
18
+
19
+ ### Inspect or migrate the artifact root
20
+
21
+ ```text
9
22
  comet native root show
10
23
  comet native root move <artifact-root>
24
+ ```
11
25
 
12
- comet native new <change-name> [--language en|zh-CN]
13
- comet native list [--cursor <token>]
14
- comet native show <change-name>
26
+ `artifact-root` is project-relative.
27
+
28
+ - `root show` is read-only. It returns the project root, configured artifact root, effective Native directory, language, and any unfinished migration.
29
+ - `root move` is a transactional write operation. Run it only when the user explicitly wants to migrate the entire Native artifact root; it moves Native data and updates configuration. Do not simulate migration by editing configuration directly.
30
+
31
+ An unfinished migration blocks other Native writes. Run read-only `doctor` first, then follow its report and use `doctor --repair` to recover.
32
+
33
+ ### Discover and read changes (read-only)
34
+
35
+ ```text
15
36
  comet native status [--cursor <token>]
16
37
  comet native status <change-name> [--details [--acceptance-cursor <token>]]
38
+ comet native show <change-name>
39
+ ```
40
+
41
+ `status` without a change name returns paginated candidates. When multiple reasonable candidates remain, show the candidates and their phases to the user and ask them to choose. Do not guess.
42
+
43
+ - `status <change-name>` returns the phase, revision, check summary, next command, and continuation. Add `--details` when findings, checkpoint details, or acceptance items are needed.
44
+ - `show` returns state, the brief, and proposed specs. Use it only after identifying the target change to read requirements and specifications; it does not replace the phase and continuation check.
45
+ - When `findingsTruncated` is true, handle the returned findings and read details again.
46
+ - When `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`.
47
+ - When a change collection has a non-null `nextCursor`, continue with `--cursor`.
48
+
49
+ These commands do not modify selection, phase, or change content.
50
+
51
+ ### Resume an existing change
52
+
53
+ ```text
17
54
  comet native select <change-name>
18
- comet native spec remove <change-name> <capability>
19
- comet native spec rebase <change-name> --summary <text>
20
55
  ```
21
56
 
22
- `artifact-root` is project-relative. `new` creates default configuration and `<project>/docs/comet/` when configuration is absent. Use `root move` to migrate an existing root; do not edit configuration directly.
57
+ Run this only after the target change is unique or the user has explicitly selected it. `select` updates only the current Native selection and does not change the phase. A successful result returns that change's continuation.
23
58
 
24
- `status` and `show` are read-only. `new` and `select` establish the current Native selection. Ask the user when multiple candidates cannot be resolved uniquely.
59
+ After selecting, reread `status <change-name>`, confirm the phase, and then load the reference for that phase. Do not treat `select` as a phase-transition command.
25
60
 
26
- `status <change-name> --details` returns detailed findings and an acceptance page:
61
+ ### Create a new change
27
62
 
28
- - when `findingsTruncated` is true, handle the returned findings and read details again;
29
- - when `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`;
30
- - when a change collection has a non-null `nextCursor`, continue with `--cursor`.
63
+ ```text
64
+ comet native new <change-name> [--language en|zh-CN]
65
+ ```
66
+
67
+ Run `new` only after confirming that no matching active change exists. When configuration is absent, it creates the default Native configuration and `docs/comet/`; it then creates a Shape change, makes it the current selection, and returns a continuation.
31
68
 
32
- When concurrent canonical changes cause a conflict, reread and rewrite the complete target specification before running `spec rebase`. Do not edit operations or hashes manually.
69
+ Immediately run `show <change-name>` and `status <change-name>`, then enter Shape clarification and shared-understanding confirmation. Do not create a new change to bypass a blocker, conflict, or recovery problem in an existing change.
70
+
71
+ ### Correct the specification history
72
+
73
+ ```text
74
+ comet native spec remove <change-name> <capability>
75
+ comet native spec rebase <change-name> --summary <text>
76
+ ```
77
+
78
+ Neither command is an ordinary file-editing command. `spec remove` records a specification operation that removes a capability; use it only when the target behavior truly requires that capability to be removed. `spec rebase` handles concurrent canonical specification changes only: reread the canonical specification, rewrite the complete target specification, and use the summary to record why the rebase was needed.
79
+
80
+ Both `spec remove` and `spec rebase` modify the change's specification history and return a new continuation. Immediately reread `status <change-name>` afterward. Do not edit operations, base hashes, or Runtime state manually.
33
81
 
34
82
  ## Checkpoints and checks
35
83
 
@@ -66,53 +114,23 @@ Manual observation:
66
114
  ```text
67
115
  comet native receipt manual <change-name> \
68
116
  --acceptance <id> \
69
- --responsible <text> \
70
117
  --step <text> \
71
- --observation <text> \
72
- --confirmed
118
+ --observation <text>
73
119
  ```
74
120
 
75
121
  Create receipts only for commands or manual observations that actually occurred. Failed, skipped, blocked, or timed-out results cannot support pass.
76
122
 
77
- ## External review handoff
78
-
79
- A high-risk change may require an implementation attestation, independent review, or waiver before it can pass. The current Agent may prepare and finalize handoff artifacts, but must not perform an external role's approve or sign action or receive its private key.
80
-
81
- Implementation handoff:
123
+ Refresh stale receipts in bulk:
82
124
 
83
125
  ```text
84
- comet native receipt implement <change-name> prepare \
85
- --identity <implementation-identity> \
86
- --output <preparation.json>
87
-
88
- comet native receipt implement <change-name> finalize \
89
- --preparation <preparation.json> \
90
- --attestation <owner-provided-attestation.json> \
91
- --confirmed
126
+ comet native receipt refresh <change-name> [--apply]
92
127
  ```
93
128
 
94
- Independent-review handoff:
129
+ A receipt is bound to the revision, contract, scope, snapshot, and artifacts in effect when it was issued. Any state write (checkpoint, spec refresh, phase advance) bumps the revision, which invalidates receipts issued before that bump. `next --result` then fails with `verification-receipt-binding-mismatch`, listing each stale receipt and the diverging field.
95
130
 
96
- ```text
97
- comet native receipt review <change-name> prepare \
98
- --implementation-receipt <ref> \
99
- --report <verification.md> \
100
- --required-receipt <ref> \
101
- --identity <reviewer-identity> \
102
- [--unified-io-receipt <ref> \
103
- --adversarial-paths-receipt <ref> \
104
- --generated-assets-receipt <ref> \
105
- --lifecycle-eval-receipt <ref>] \
106
- --output <preparation.json>
107
-
108
- comet native receipt review <change-name> finalize \
109
- --preparation <preparation.json> \
110
- --approval <reviewer-provided-approval.json> \
111
- --attestation <reviewer-provided-attestation.json> \
112
- --confirmed
113
- ```
131
+ Without `--apply` (default) it is a preview: it reports which manual receipts are stale, which automated receipts must be re-run, and which required-check receipts must be regenerated via `comet native check`, without touching any file.
114
132
 
115
- The external role completes approval or signing from the preparation and returns only public artifacts. When the Runtime requires a waiver, an external waiver signer also executes the command supplied by the continuation; the current Agent submits only the returned waiver ref.
133
+ With `--apply`: it re-issues only stale manual receipts whose binding mismatch is limited to `sourceRevision`, and writes the canonical evidence block back into the `# Acceptance evidence` section of verification.md. Contract, scope, snapshot, or artifact mismatches remain manual verification blockers. Automated receipts are never silently re-issued (they attest to a real command execution); refresh only reports the commands you must re-run via `receipt automated`.
116
134
 
117
135
  ## Phase progression
118
136
 
@@ -124,12 +142,6 @@ comet native next <change-name> --summary <text> \
124
142
  [--allow-partial-scope <sha256> --partial-reason <text> --confirmed] \
125
143
  [--result pass|fail] \
126
144
  [--report <change-relative-path>] \
127
- [--receipt <required-receipt-ref>] \
128
- [--evidence-receipt <acceptance-receipt-ref>]... \
129
- [--waiver <waiver-ref>]... \
130
- [--independent-review-receipt <review-receipt-ref>] \
131
- [--failure-category <token>]... \
132
- [--failed-check <token>]... \
133
145
  [--override-repair <sha256> --override-summary <text>]
134
146
 
135
147
  comet native archive <change-name> --dry-run
@@ -137,9 +149,9 @@ comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
137
149
  ```
138
150
 
139
151
  - Shape: pass `--confirmed` only after the user confirms the final shared understanding.
140
- - Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed.
152
+ - Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed. If changed requirements introduce a new user decision, stay in Build and repeat clarification and confirmation first. After confirmation, update the formal artifacts, then run the transition command returned by the Runtime with `--confirmed`.
141
153
  - Partial scope: explain the exact gaps and risks returned by the Runtime. Changes beyond the returned detail budget are summarized by a `scope-detail-overflow` count and content hash; use the matching scope hash, reason, and `--confirmed` only after the user accepts them.
142
- - Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`; pass requires current receipts requested by the Runtime, and fail uses stable, non-sensitive failure categories and check IDs.
154
+ - Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`. On pass, the Runtime runs the built-in required check automatically. Acceptance entries in the report reference automated/manual receipts directly. Executed failures reference their failed receipts, while checks that were not run include a `skipped_reason`. The Runtime derives failed acceptance and check identifiers from the report and receipts.
143
155
  - Repair override: use only the signature returned by status and only for one explicit new repair hypothesis.
144
156
  - Archive: dry-run first, then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation.
145
157
 
@@ -39,6 +39,8 @@ The only safe options are:
39
39
 
40
40
  Changes to the brief, specifications, implementation, report, or receipts may stale the old scope or Verify pass. Follow the continuation back to Build, reconfirm changed user-visible behavior, generate a new scope, and verify again. Do not reuse an old pass or preflight.
41
41
 
42
+ Receipts are bound to revision: every state write (checkpoint, spec refresh, phase advance) bumps the revision, which invalidates receipts issued before that bump. When `next --result` reports `verification-receipt-binding-mismatch`, the finding lists each stale receipt and the diverging field (e.g. `sourceRevision: expected 6, got 5`) and gives the recovery command. Only a source-revision-only mismatch on manual evidence can be refreshed without returning to Verify; run `comet native receipt refresh <change> --apply` to re-issue it at the current revision and rewrite verification.md. Contract, scope, snapshot, or artifact mismatches require fresh verification. Automated receipts must be re-executed with `receipt automated` and are never silently re-issued.
43
+
42
44
  ## Verify fail and repair stop
43
45
 
44
46
  After Verify fail returns to Build:
@@ -48,7 +50,15 @@ After Verify fail returns to Build:
48
50
  3. rerun the relevant validation;
49
51
  4. submit the Verify result again.
50
52
 
51
- When the same gap repeats or `max_verify_failures` is reached, the Runtime stops the automatic loop. Use a status-provided repair override only when the Runtime allows it and one explicit new repair hypothesis exists. Otherwise preserve the scene and ask the user whether to change scope, constraints, or stop.
53
+ When the same gap appears for the third time, the Runtime returns `repair-stagnation-stop`. This is not a user decision: read the signature from status, form one concrete new repair hypothesis that differs from the previous attempt, make the corresponding change, and use that signature and hypothesis summary for one repair override. Do not ask the user for a signature, hash, or override argument.
54
+
55
+ When the override is exhausted or `native.max_verify_failures` is reached, the continuation returns `await-user` with `repair-continuation-decision`. Explain the current failure and attempted approaches, then ask the user to choose only:
56
+
57
+ 1. continue trying: increase `native.max_verify_failures` and continue;
58
+ 2. change the confirmed contract: return to Shape, update the brief and complete target specification, and reconfirm;
59
+ 3. stop this repair: preserve the change and current scene without progressing or running Archive.
60
+
61
+ The user chooses only the direction. You update configuration or formal artifacts, read the Runtime signature, and execute the follow-up commands.
52
62
 
53
63
  ## Canonical specification conflict
54
64