@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
@@ -7,15 +7,6 @@ description: 当用户明确调用 /comet-native、要求启动或恢复 Native
7
7
 
8
8
  Native 保存需求、完整目标规格、状态和证据。你负责理解、实现和验证;Runtime 负责状态、边界和恢复。
9
9
 
10
- ## 按需加载
11
-
12
- 先只使用本文件。遇到对应任务时再读取一份 reference:
13
-
14
- - Shape 中存在尚未确定的用户可见行为时,读取[澄清参考](reference/clarification.md)。
15
- - 需要高级参数、receipt、partial scope 或外部角色交接命令时,读取[命令参考](reference/commands.md)。
16
- - 需要编辑 brief、规格或 verification 时,读取[产物参考](reference/artifacts.md)。
17
- - 出现中断、失效证据、repair stop、冲突、锁或迁移问题时,读取[恢复参考](reference/recovery.md)。
18
-
19
10
  ## 核心规则
20
11
 
21
12
  从 `.comet/config.yaml` 读取:
@@ -28,15 +19,27 @@ Native 保存需求、完整目标规格、状态和证据。你负责理解、
28
19
 
29
20
  Native 主流程不依赖任何外部 Skill。
30
21
 
31
- 不要接收签名私钥,也不要代替外部审批角色。缺少外部动作时,按 Runtime continuation 等待并转交所需命令。
22
+ ## CLI 引导
23
+
24
+ Native Skill 只使用 PATH 中的公开 `comet native <cmd>` CLI;随 Skill 发布的命令 bundle 属于内部安装与 Runtime 资产,不由 Skill 搜索或直接调用。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整;不得搜索 Skill 文件、枚举平台目录或直接调用内部 bundle。
25
+
26
+ 常用命令:
27
+
28
+ ```bash
29
+ comet native status [--json]
30
+ comet native show <change-name>
31
+ comet native select <change-name>
32
+ comet native new <change-name> [--language en|zh-CN]
33
+ comet native next <change-name> --summary <text> [--confirmed]
34
+ comet native archive <change-name> --dry-run
35
+ ```
32
36
 
33
37
  ## 开始或恢复
34
38
 
35
39
  1. 运行 `comet native status`,确认当前 change 和 phase。
36
- 2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再运行 `status <change-name> --details`。
40
+ 2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再对 status 命令加 `--details` 运行。
37
41
  3. 需要更多 acceptance 时,按 `acceptancePage.nextCursor` 分页;findings 被截断时,先处理已返回项,再重新读取。
38
42
  4. 确认目标后运行 `comet native select <change-name>`。
39
- 5. 只读取当前 phase 需要的正式产物、实现、测试和项目规则。
40
43
 
41
44
  存在多个合理候选时让用户选择。只有确认没有对应 active change 时才创建:
42
45
 
@@ -47,11 +50,20 @@ comet native new <change-name> \
47
50
 
48
51
  只使用配置指定的 Native artifact root。
49
52
 
53
+ ## 按需加载
54
+
55
+ 确认当前 change 和 phase 后,再按需读取一份对应 reference:
56
+
57
+ - 进入 Shape 时,必须先读取并执行[澄清参考](reference/clarification.md)。不得以“需求看起来明确”为由跳过;完成共享理解确认前,不得修改项目实现或推进到 Build。
58
+ - 需要高级参数、receipt 或 partial scope 命令时,读取[命令参考](reference/commands.md)。
59
+ - 需要编辑 brief、规格或 verification 时,读取[产物参考](reference/artifacts.md)。
60
+ - 出现中断、失效证据、repair stop、冲突、锁或迁移问题时,读取[恢复参考](reference/recovery.md)。
61
+
50
62
  ## Shape
51
63
 
52
64
  先调查能从仓库、工具和运行环境查明的事实。只有不同选择会实质改变用户可见结果,并且无法从已有要求可靠确定时,才询问用户;实现方式由你决定。
53
65
 
54
- 存在未决行为时,按 `clarification_mode` 读取并执行澄清参考。每次用户回答后,立即更新同一个 change 的 Decisions、brief 和完整目标规格。未解决项继续以 `[blocking]` 保存;存在阻塞项时不修改项目实现,也不推进阶段。
66
+ 按 `clarification_mode` 执行澄清参考。即使初步判断没有未决行为,也必须完成其中的信息分类和静默假设检查。每次用户回答后,立即更新同一个 change 的 Decisions、brief 和完整目标规格。未解决项继续以 `[blocking]` 保存;存在阻塞项时不修改项目实现,也不推进阶段。
55
67
 
56
68
  所有用户决定处理完后,重新检查是否仍有静默假设,并向用户提供目标、范围、关键决定、验收标准和非目标的共享理解摘要。只有用户明确确认后,才移除最终阻塞项并推进:
57
69
 
@@ -65,14 +77,15 @@ brief 或规格改变已确认的行为时,重新取得用户确认;不要
65
77
 
66
78
  实现满足 brief 和完整目标规格的最简单可靠方案。可以分批完成;长任务可使用 checkpoint 保存恢复摘要,但 checkpoint 不是完成证据。
67
79
 
68
- 需求变化时先更新正式产物。出现新的用户决定时回到 Shape 的澄清与确认边界。
80
+ 需求变化时先更新正式产物。出现新的用户决定时保持在 Build,但重新执行 Shape 的澄清与确认边界:保存 `[blocking]`、暂停实现并询问用户。用户确认后,更新 Decisions、brief 和完整目标规格并移除阻塞项;离开 Build 时执行 Runtime 返回的命令并传入 `--confirmed`。
69
81
 
70
82
  候选实现完成后,对照完整规格和全部 acceptance 复核是否仍有遗漏,再提供真实项目产物推进:
71
83
 
72
84
  ```text
73
85
  comet native next <change-name> \
74
86
  --summary <摘要> \
75
- --artifact <项目内路径>
87
+ --artifact <项目内路径> \
88
+ [--confirmed]
76
89
  ```
77
90
 
78
91
  没有代码变化或 Runtime 无法证明完整 scope 时,读取命令参考。不得把未知或不完整范围声明为 complete。
@@ -81,23 +94,23 @@ comet native next <change-name> \
81
94
 
82
95
  进入 Build 后按以下循环收敛:
83
96
 
84
- 1. 运行 `status <change-name> --details` 并读取当前需要的 acceptance 页;上一轮 Verify 失败时,优先处理 failed/missing acceptance 和 failed check。
97
+ 1. 运行 `comet native status <change-name> --details`,读取当前需要的 acceptance 页;上一轮 Verify 失败时,优先处理 failed/missing acceptance 和 failed check。
85
98
  2. 完成一批相关的实际修复。需要中断时可以写 checkpoint,但 checkpoint 不是完成证据。
86
99
  3. 形成候选实现后,重新读取 brief、完整规格和全部 acceptance,执行一次完整审查。
87
100
  4. 运行真实验证并提交 Verify 结果。
88
101
  5. `fail` 回到 Build,从第 1 步继续,且不运行 Archive;`pass` 才进入 Archive。
89
102
 
90
- Loop 只在 `done`、`await-user`、`blocked` 或调用方明确要求停止时结束。一次 Agent turn、一次 checkpoint 或 Agent 自述“已完成”都不是终态。Agent 负责发现并修复缺口,Runtime 负责判断是否完成。
103
+ `blocked` 会暂停正常 Build → Verify 循环并进入恢复分支。处理 findings 后,根据新的 continuation 从第 1 步恢复循环。只有 `done`、`await-user` 或调用方明确要求停止时,才结束当前工作。一次 Agent turn、一次 checkpoint、一次 `blocked` 或 Agent 自述“已完成”都不是终态。Agent 负责发现并修复缺口,Runtime 负责判断是否完成。
91
104
 
92
105
  ## Verify
93
106
 
94
107
  根据 acceptance、完整目标规格和改动风险运行真实验证。用实际结果完成 `verification.md` 和验收证据;未运行或失败的检查不能写成通过。
95
108
 
96
- 使用 Runtime 返回的 acceptance ID 和 receipt。需要生成证据块、记录 automated/manual receipt、申请 waiver 或交接独立审核时,读取产物与命令参考。当前 Agent 不执行外部签名。
109
+ 使用 Runtime 返回的 acceptance ID 和 receipt。需要生成证据块或记录 automated/manual receipt 时,读取产物与命令参考。
97
110
 
98
- 只有 Runtime 接受完整且新鲜的验收矩阵、required checks 和独立审核时才能提交 `pass`。相关实现、规格、报告或证据改变后重新验证。
111
+ 只有 Runtime 接受完整且新鲜的验收矩阵和 required checks 时才能提交 `pass`。相关实现、规格、报告或证据改变后重新验证。
99
112
 
100
- `fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next` 当作修复。达到 Runtime 的重复缺口停止条件或 `native.max_verify_failures` 预算时,停止并等待用户决定。
113
+ `fail` 会回到 Build。先根据 Runtime 返回的 failed/missing acceptance 和 failed check 修复,再重新验证;不要把再次调用 `next` 当作修复。`repair-stagnation-stop` 由 Agent 按恢复参考提出新假设并使用 Runtime 返回的 override;只有 continuation 要求 `repair-continuation-decision` 时才等待用户选择。
101
114
 
102
115
  Verify 失败的中间循环不运行 Archive,也不触发归档确认。持续执行 Build → Verify,直到 pass、Runtime 阻塞或需要用户决定。
103
116
 
@@ -121,8 +134,8 @@ comet native archive <change-name> --dry-run
121
134
  Shape、Build 和 Verify 的 transition 都会返回 `next: auto | manual`、`continuation.disposition: continue | await-user | blocked | done`、所需输入与下一步动作;Archive 不通过 `next` 推进,归档成功才返回 `done`。每次 transition 后按该 Runtime continuation 行动:
122
135
 
123
136
  - `continue`:重新读取 phase 和当前所需产物后继续;
124
- - `await-user`:等待确实属于用户或外部角色的输入;
125
- - `blocked`:处理 findings,必要时读取恢复参考;
137
+ - `await-user`:等待确实需要用户决定或补充的输入;
138
+ - `blocked`:暂停正常循环,处理 findings,必要时读取恢复参考;处理后按新的 continuation 恢复,不因 `blocked` 本身结束任务;
126
139
  - `done`:change 已完成。
127
140
 
128
141
  `next: auto` 只表示本次 transition 成功,不表示后续步骤已执行。调用方明确要求在某次 transition 后停止时,严格按“更新正式产物 → 执行一次允许的 transition → transition 成功后不再调用工具 → 输出约定标记并结束本轮”执行;即使 continuation 为 `continue` 也不得继续执行后续步骤。
@@ -124,18 +124,11 @@ comet native evidence format [--entries <path>]
124
124
  "status": "failed",
125
125
  "evidence_refs": [],
126
126
  "skipped_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` 引用当前有效的 typed receipt。
138
132
  - `failed` 说明真实失败或跳过原因。
139
- - `waived` 引用外部 signer 返回的 waiver。
140
133
 
141
134
  不要手工排版机器块,不要复用旧 change 的 evidence ref,也不要把失败、跳过或阻塞结果写成通过。
@@ -1,6 +1,6 @@
1
1
  # Native 澄清参考
2
2
 
3
- 只在 Shape 存在尚未确定的用户可见行为时读取本文件。
3
+ 进入 Shape 后必须读取本文件。完成问题判定、静默假设检查和共享理解确认前,不得修改项目实现或推进到 Build。
4
4
 
5
5
  ## 是否需要提问
6
6
 
@@ -1,35 +1,83 @@
1
1
  # Native 命令参考
2
2
 
3
- 只在需要主 Skill 未列出的参数、receipt、partial scope、外部角色交接或恢复命令时读取本文件。
3
+ 只在需要主 Skill 未列出的参数、receipt、partial scope 或恢复命令时读取本文件。
4
4
 
5
5
  ## 项目与 change
6
6
 
7
+ 先判断当前意图;不要按本节顺序逐条执行。只读命令用于确认事实,写命令只在对应条件满足时执行。执行写命令后立即重读 `status <change-name>`,按返回的 phase 和 continuation 决定下一步。
8
+
9
+ ### 首次启用 Native
10
+
7
11
  ```text
8
12
  comet native init [--root <artifact-root>] [--language en|zh-CN]
13
+ ```
14
+
15
+ 只在项目尚未启用 Native,或需要补齐 Native 目录与语言配置时使用。它会创建所需目录并写入 `.comet/config.yaml`;已有配置会保留当前 artifact root,但可更新语言。`init` 不迁移已有 artifact root;显式 `--root` 与现有配置冲突时命令会失败。
16
+
17
+ 完成后运行 `root show` 确认实际位置。不要在已经存在 change 时把 `init` 当作恢复命令。
18
+
19
+ ### 查看或迁移 artifact root
20
+
21
+ ```text
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` 是项目内相对路径。
27
+
28
+ - `root show` 是只读命令,返回项目根、配置的 artifact root、实际 Native 目录、语言和未完成迁移。
29
+ - `root move` 是事务性写操作,只在用户明确要迁移整个 Native artifact root 时执行;它会移动 Native 数据并更新配置。不要直接编辑配置模拟迁移。
30
+
31
+ 迁移未完成时,其他 Native 写操作会被阻塞。先运行只读 `doctor`,再按报告使用 `doctor --repair` 恢复。
32
+
33
+ ### 发现并读取 change(只读)
34
+
35
+ ```text
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
+ 无 change 名称的 `status` 返回分页候选。存在多个合理候选时,把候选及 phase 展示给用户选择,不要猜测。
42
+
43
+ - `status <change-name>` 返回 phase、revision、检查摘要、下一条命令和 continuation;需要 findings、checkpoint 细节或 acceptance 时加 `--details`。
44
+ - `show` 返回 state、brief 和 proposed specs;只在已经确定目标 change 后使用它读取需求与规格,不用它代替 phase/continuation 检查。
45
+ - `findingsTruncated` 为 true 时,先处理已返回项,再重新读取。
46
+ - `acceptancePage.nextCursor` 非空时,用 `--acceptance-cursor` 继续读取。
47
+ - change 集合的 `nextCursor` 非空时,用 `--cursor` 继续读取。
48
+
49
+ 这些命令都不修改 selection、phase 或 change 内容。
50
+
51
+ ### 恢复已有 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` 是项目内相对路径。`new` 在配置缺失时创建默认配置和 `<project>/docs/comet/`。已有配置需要迁移根目录时使用 `root move`,不要直接改配置。
57
+ 只在目标 change 已唯一确定或由用户明确选择后执行。`select` 只更新当前 Native selection,不改变 phase;成功结果会返回该 change 的 continuation。
23
58
 
24
- `status` 和 `show` 是只读命令。`new` 和 `select` 会建立当前 Native selection。多个候选无法唯一判断时让用户选择。
59
+ 选择后重新读取 `status <change-name>`,确认 phase,再加载该 phase 对应的 reference。不要把 `select` 当作阶段推进命令。
25
60
 
26
- `status <change-name> --details` 返回详细 findings 和 acceptance 页:
61
+ ### 创建新 change
27
62
 
28
- - `findingsTruncated` 为 true 时,先处理已返回项,再重新读取;
29
- - `acceptancePage.nextCursor` 非空时,用 `--acceptance-cursor` 继续读取;
30
- - change 集合的 `nextCursor` 非空时,用 `--cursor` 继续读取。
63
+ ```text
64
+ comet native new <change-name> [--language en|zh-CN]
65
+ ```
66
+
67
+ 只有确认没有对应 active change 时才运行 `new`。配置缺失时,它会创建默认 Native 配置与 `docs/comet/`;随后创建一个 Shape change、把它设为当前 selection,并返回 continuation。
68
+
69
+ 创建后立即运行 `show <change-name>` 与 `status <change-name>`,然后进入 Shape 澄清与共享理解确认。不要创建新 change 来绕过旧 change 的阻塞、冲突或恢复问题。
31
70
 
32
- canonical 规格发生并发变化时,先重读并改写完整目标规格,再运行 `spec rebase`。不要手改 operation 或 hash。
71
+ ### 修正规格轨迹
72
+
73
+ ```text
74
+ comet native spec remove <change-name> <capability>
75
+ comet native spec rebase <change-name> --summary <text>
76
+ ```
77
+
78
+ 这两条都不是普通文件编辑命令。`spec remove` 把 capability 记录为待移除的规格操作;只在目标行为确实要求移除该 capability 时使用。`spec rebase` 只处理 canonical 规格发生并发变化的情况:先重读 canonical 规格并改写完整目标规格,再用摘要记录 rebase 原因。
79
+
80
+ `spec remove` 和 `spec rebase` 都会修改 change 的规格轨迹并返回新的 continuation。执行后立即重读 `status <change-name>`;不要手改 operation、base hash 或 Runtime 状态。
33
81
 
34
82
  ## Checkpoint 与检查
35
83
 
@@ -66,53 +114,23 @@ comet native receipt automated <change-name> \
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
  只为真实执行的命令或人工观察生成 receipt。失败、跳过、阻塞或超时结果不能作为 pass。
76
122
 
77
- ## 外部审核交接
78
-
79
- 高风险 change 的 pass 可能要求 implementation attestation、independent review 或 waiver。当前 Agent 可以准备和最终导入交接产物,但不得执行外部角色的 approve/sign,也不得接收其私钥。
80
-
81
- Implementation 交接:
123
+ 批量刷新过期 receipt:
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 交接:
129
+ receipt 绑定生成时的 revision、contract、scope、snapshot 与 artifact。任何一次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,导致此前签发的 receipt 绑定过期。`next --result` 会因此报 `verification-receipt-binding-mismatch` 并列出每个过期 receipt 及其不一致字段。
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
+ 不带 `--apply`(默认)为预览:只报告哪些 manual receipt 过期、哪些 automated receipt 需重跑、哪些 required-check receipt 需用 `comet native check` 重生成,不改动任何文件。
114
132
 
115
- 外部角色根据 preparation 完成审批或签名,并只把公开产物返回当前 Agent。Runtime 要求 waiver 时,也由外部 waiver signer 执行 continuation 指定的命令;当前 Agent 只提交返回的 waiver ref。
133
+ 带 `--apply` 时:只对绑定不一致仅限于 `sourceRevision` 的过期 manual receipt 按当前 revision 重新签发,并把规范证据块写回 verification.md 的 `# Acceptance evidence` 段;contract、scope、snapshot 或 artifact 不一致仍会阻塞并要求重新人工验证。automated receipt 不会被静默重签(它证明一次真实命令执行),refresh 只报告需重跑的命令让你用 `receipt automated` 重新执行。
116
134
 
117
135
  ## 阶段推进
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:只有用户确认最终共享理解后才传 `--confirmed`。
140
- - Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。
152
+ - Build:提供真实 `--artifact`;确实没有项目文件变化时使用 `--no-code-reason`。如果需求变化引入新的用户决定,先保持在 Build 并重新完成澄清与确认;确认后更新正式产物,再执行 Runtime 返回的 transition 命令并传入 `--confirmed`。
141
153
  - Partial scope:先向用户说明 Runtime 返回的具体缺口和风险。超出已返回明细预算的变化由 `scope-detail-overflow` 数量和内容 hash 汇总;只有用户接受后才使用完全匹配的 scope hash、理由和 `--confirmed`。
142
- - Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md`;pass 需要 Runtime 要求的当前 receipts,fail 使用稳定、非敏感的失败分类和检查 ID。
154
+ - Verify:提供 `--result` 和完整报告。标准报告路径提交为 `comet native next <change-name> --summary <摘要> --result pass|fail --report verification.md`。Runtime 在 pass 时自动执行内置 required check;报告中的 acceptance 条目直接引用 automated/manual receipt。已执行但失败的条目引用对应失败 receipt,未执行的条目写明 `skipped_reason`。repair 的失败 acceptance 和检查标识由 Runtime 从报告与 receipt 自动推导。
143
155
  - Repair override:只使用 status 返回的 signature,并且只在有一个明确新修复假设时执行。
144
156
  - Archive:先 dry-run,再使用本次预演返回的精确 preflight hash;`required` 模式还需要用户明确确认。
145
157
 
@@ -39,6 +39,8 @@ comet native doctor <change-name> --repair --strategy continue
39
39
 
40
40
  brief、规格、实现、报告或 receipt 改变后,旧 scope 或 Verify pass 可能失效。按 continuation 回到 Build,重新确认发生变化的用户行为、生成新 scope 并重新验证。不要复用旧 pass 或旧 preflight。
41
41
 
42
+ receipt 与 revision 绑定:每次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,此前签发的 receipt 会因此绑定过期。`next --result` 报 `verification-receipt-binding-mismatch` 时,finding 会列出每个过期 receipt 及其不一致字段(如 `sourceRevision: expected 6, got 5`),并给出恢复命令。只有 manual evidence 仅发生 sourceRevision 不一致时,才可以不回到 Verify,运行 `comet native receipt refresh <change> --apply` 按当前 revision 重签并写回 verification.md;contract、scope、snapshot 或 artifact 不一致都必须重新验证。automated receipt 必须用 `receipt automated` 重新执行原命令,不能静默重签。
43
+
42
44
  ## Verify fail 与 repair stop
43
45
 
44
46
  Verify fail 回到 Build 后:
@@ -48,7 +50,15 @@ Verify fail 回到 Build 后:
48
50
  3. 重新运行相关验证;
49
51
  4. 再提交 Verify 结果。
50
52
 
51
- 相同缺口重复出现或达到 `max_verify_failures` 时,Runtime 会停止自动循环。只有 status 返回允许的 repair override,并且存在一个明确的新修复假设时,才能使用该 signature 和摘要重试一次;否则保留现场并让用户决定范围、约束或是否停止。
53
+ 相同缺口第三次出现时,Runtime 返回 `repair-stagnation-stop`。这不是用户决策:Agent 从 status 读取 signature,提出一个与上一轮不同且具体的新的修复假设,完成对应修改后,使用该 signature 和假设摘要执行一次 repair override。不要让用户提供 signature、hash 或 override 参数。
54
+
55
+ override 已耗尽或达到 `native.max_verify_failures` 时,continuation 返回 `await-user` 和 `repair-continuation-decision`。向用户说明当前失败和已尝试方案,只让用户选择:
56
+
57
+ 1. 继续尝试:由 Agent 提高 `native.max_verify_failures` 后继续;
58
+ 2. 调整已确认契约:回到 Shape 更新 brief 和完整目标规格,并重新确认;
59
+ 3. 停止本次修复:保留 change 和当前现场,不继续推进或 Archive。
60
+
61
+ 用户只做方向选择;Agent 负责修改配置或正式产物、读取 Runtime signature,并执行后续命令。
52
62
 
53
63
  ## Canonical spec 冲突
54
64
 
@@ -29,7 +29,7 @@ Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程
29
29
 
30
30
  执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。
31
31
 
32
- 开始前按 `comet/reference/scripts.md` 定位 Comet 脚本(定位 `comet-env.mjs`);从任意入口恢复时先按 `comet/reference/context-recovery.md` 确认 phase/workflow。
32
+ 开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
33
33
 
34
34
  恢复已有 tweak change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
35
35
 
@@ -153,7 +153,7 @@ comet state set <change-name> verify_mode full
153
153
  <IMPORTANT>
154
154
  Tweak 流程默认 **一次性连续执行**。调用 `/comet-tweak` 后,agent 在 tweak 自有步骤间自动推进,不主动停顿。**例外**:若 `auto_transition: false`,则在每个 phase 边界(build/verify/archive 之间)结束当前调用并按 `HINT` 交还控制权,由用户稍后手动运行下一阶段命令;这是手动衔接,不是新的确认点。无论 `auto_transition` 取何值,以下真正的用户决策仍需暂停:
155
155
 
156
- 1. 遇到升级判定信号(见「升级判定」章节),**必须使用当前平台可用的用户输入/确认机制暂停并等待用户明确选择**:继续 tweak 轻量流程,还是升级为完整 `/comet-classic` 流程
156
+ 1. 遇到升级判定信号(见「升级判定」章节),**必须暂停、展示选择并等待用户明确选择**:继续 tweak 轻量流程,还是升级为完整 `/comet-classic` 流程
157
157
  2. 验证阶段(comet-verify)接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移或超过自动修复上限后的策略决策;前 3 次明确可修复失败自动闭环
158
158
  3. 归档前最终确认,以及归档提交后的分支处理决策
159
159
 
@@ -63,7 +63,7 @@ comet state get <change-name> plan
63
63
  git diff --stat <从 plan frontmatter 读取的 base-ref>...HEAD
64
64
  ```
65
65
 
66
- 第一条命令返回 plan 路径;使用当前平台的文件读取能力解析其 frontmatter 中唯一的 `base-ref`,确认它是有效提交后再代入第二条命令。不得依赖 POSIX 文本管道。
66
+ 第一条命令返回 plan 路径;使用文件读取工具解析其 frontmatter 中唯一的 `base-ref`,确认它是有效提交后再代入第二条命令。不得依赖 POSIX 文本管道。
67
67
 
68
68
  若提交区间显示改动超过轻量阈值(> 8 个文件、跨模块协调、或 delta spec 超过 1 个 capability),手动设置为完整验证:
69
69
 
@@ -173,7 +173,7 @@ comet state transition <change-name> verify-fail
173
173
  ```
174
174
 
175
175
  **Spec 漂移处理**(用户决策点):
176
- - 若检查项 6 发现矛盾(delta spec 有内容但 design doc 未体现),**必须使用当前平台可用的用户输入/确认机制以单选题形式暂停并等待用户选择处理方式**,不得自动选择。选项:
176
+ - 若检查项 6 发现矛盾(delta spec 有内容但 design doc 未体现),**必须以单选题形式暂停、展示处理方式并等待用户选择**,不得自动选择。选项:
177
177
  - 选项 A:在 design doc 追加 "Implementation Divergence" 节记录偏差原因。选项 A 属于 verify 阶段允许产物;写入后不得因该 design doc 变更再次触发 Step 1b dirty-worktree 决策
178
178
  - 选项 B:用户选择 B 后,运行 `comet state transition <change-name> verify-fail`,然后调用 `/comet-build`;由 `/comet-build` 的 Spec 增量更新规则加载 Superpowers `brainstorming` 更新 Design Doc + delta spec
179
179
  - 选项 C:确认偏差可接受,继续验证(归档时 design doc 将标记为 `superseded-by-main-spec`)
@@ -186,7 +186,7 @@ comet state transition <change-name> verify-fail
186
186
  comet state set <change-name> verification_report docs/superpowers/reports/YYYY-MM-DD-<change-name>-verify.md
187
187
  ```
188
188
 
189
- 使用当前平台的文件能力创建 `docs/superpowers/reports/` 和报告文件,不依赖 POSIX 专用目录命令。
189
+ 使用文件工具创建 `docs/superpowers/reports/` 和报告文件,不依赖 POSIX 专用目录命令。
190
190
 
191
191
  ## 退出条件
192
192
 
package/bin/comet.js CHANGED
@@ -1,3 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- import '../dist/app/cli/index.js';
3
+ import { tryRunFastRuntime } from './fast-runtime-router.js';
4
+
5
+ if (!(await tryRunFastRuntime())) {
6
+ await import('../dist/app/cli/index.js');
7
+ }
@@ -0,0 +1,82 @@
1
+ import { existsSync } from 'fs';
2
+ import { fileURLToPath } from 'url';
3
+
4
+ const CLASSIC_ASSETS = {
5
+ state: 'assets/skills/comet/scripts/comet-state.mjs',
6
+ guard: 'assets/skills/comet/scripts/comet-guard.mjs',
7
+ handoff: 'assets/skills/comet/scripts/comet-handoff.mjs',
8
+ archive: 'assets/skills/comet/scripts/comet-archive.mjs',
9
+ };
10
+
11
+ const NATIVE_COMMANDS = new Set([
12
+ 'init',
13
+ 'root',
14
+ 'new',
15
+ 'spec',
16
+ 'show',
17
+ 'status',
18
+ 'select',
19
+ 'checkpoint',
20
+ 'check',
21
+ 'evidence',
22
+ 'receipt',
23
+ 'next',
24
+ 'archive',
25
+ 'doctor',
26
+ ]);
27
+
28
+ function hasHelpFlag(args) {
29
+ const separator = args.indexOf('--');
30
+ const commandArgs = separator < 0 ? args : args.slice(0, separator);
31
+ return commandArgs.includes('--help') || commandArgs.includes('-h');
32
+ }
33
+
34
+ /**
35
+ * Resolves only public commands whose package-owned self-contained runtime has
36
+ * the same argv contract. Returning null preserves Commander for all other
37
+ * commands, including help and unknown-command diagnostics.
38
+ */
39
+ export function resolveFastRuntime(argv) {
40
+ if (argv.length === 0 || hasHelpFlag(argv)) return null;
41
+
42
+ const [group, command, ...tail] = argv;
43
+ const classicAsset = CLASSIC_ASSETS[group];
44
+ if (classicAsset) return { assetPath: classicAsset, args: argv.slice(1) };
45
+
46
+ if (group === 'workflow' && command === 'resolve') {
47
+ return {
48
+ assetPath: 'assets/skills/comet/scripts/comet-entry-runtime.mjs',
49
+ args: tail,
50
+ };
51
+ }
52
+
53
+ if (group === 'native' && command && NATIVE_COMMANDS.has(command)) {
54
+ return {
55
+ assetPath: `assets/skills/comet-native/scripts/comet-native-${command}.mjs`,
56
+ args: tail,
57
+ };
58
+ }
59
+
60
+ return null;
61
+ }
62
+
63
+ function assetUrl(assetPath) {
64
+ return new URL(`../${assetPath}`, import.meta.url);
65
+ }
66
+
67
+ /**
68
+ * Runs a fast runtime in this same Node process. Package-relative resolution
69
+ * deliberately belongs to the CLI; Skills never locate or invoke bundles.
70
+ */
71
+ export async function tryRunFastRuntime(argv = process.argv.slice(2)) {
72
+ const route = resolveFastRuntime(argv);
73
+ if (!route) return false;
74
+
75
+ const runtimeUrl = assetUrl(route.assetPath);
76
+ const runtimePath = fileURLToPath(runtimeUrl);
77
+ if (!existsSync(runtimePath)) return false;
78
+
79
+ process.argv = [process.execPath, runtimePath, ...route.args];
80
+ await import(runtimeUrl.href);
81
+ return true;
82
+ }