@rpamis/comet 0.4.0-beta.10 → 0.4.0-beta.12

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 (214) hide show
  1. package/README.md +1 -1
  2. package/assets/manifest.json +1 -1
  3. package/assets/skills/comet/SKILL.md +8 -4
  4. package/assets/skills/comet/reference/classic-layout.md +3 -3
  5. package/assets/skills/comet/rules/comet-workflow-guard.en.md +4 -3
  6. package/assets/skills/comet/rules/comet-workflow-guard.md +4 -3
  7. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +145 -145
  8. package/assets/skills/comet/scripts/comet-hook-router.mjs +353 -1035
  9. package/assets/skills/comet/scripts/comet-runtime.mjs +164 -186
  10. package/assets/skills/comet-native/SKILL.md +20 -23
  11. package/assets/skills/comet-native/reference/artifacts.md +0 -7
  12. package/assets/skills/comet-native/reference/clarification.md +1 -1
  13. package/assets/skills/comet-native/reference/commands.md +63 -65
  14. package/assets/skills/comet-native/reference/recovery.md +9 -1
  15. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +2574 -5719
  16. package/assets/skills-zh/comet/SKILL.md +8 -4
  17. package/assets/skills-zh/comet/reference/classic-layout.md +3 -3
  18. package/assets/skills-zh/comet-native/SKILL.md +20 -23
  19. package/assets/skills-zh/comet-native/reference/artifacts.md +0 -7
  20. package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
  21. package/assets/skills-zh/comet-native/reference/commands.md +63 -65
  22. package/assets/skills-zh/comet-native/reference/recovery.md +9 -1
  23. package/dist/app/commands/classic.js +2 -2
  24. package/dist/app/commands/classic.js.map +1 -1
  25. package/dist/app/commands/dashboard.d.ts.map +1 -1
  26. package/dist/app/commands/dashboard.js +2 -1
  27. package/dist/app/commands/dashboard.js.map +1 -1
  28. package/dist/app/commands/doctor.d.ts.map +1 -1
  29. package/dist/app/commands/doctor.js +9 -3
  30. package/dist/app/commands/doctor.js.map +1 -1
  31. package/dist/app/commands/update.d.ts.map +1 -1
  32. package/dist/app/commands/update.js +14 -2
  33. package/dist/app/commands/update.js.map +1 -1
  34. package/dist/config/repository-layout.json +1 -4
  35. package/dist/domains/comet-classic/classic-layout-initialization.js +3 -3
  36. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
  37. package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
  38. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  39. package/dist/domains/comet-classic/classic-root-command.js +159 -49
  40. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  41. package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
  42. package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
  43. package/dist/domains/comet-classic/classic-root-move.js +24 -121
  44. package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
  45. package/dist/domains/comet-entry/current-selection-repair.js +1 -1
  46. package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
  47. package/dist/domains/comet-entry/hook-router.d.ts +12 -2
  48. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  49. package/dist/domains/comet-entry/hook-router.js +40 -14
  50. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  51. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  52. package/dist/domains/comet-entry/init-workflow.js +17 -3
  53. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  54. package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
  55. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  56. package/dist/domains/comet-native/native-acceptance.js +5 -29
  57. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  58. package/dist/domains/comet-native/native-change.d.ts +0 -2
  59. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  60. package/dist/domains/comet-native/native-change.js +8 -104
  61. package/dist/domains/comet-native/native-change.js.map +1 -1
  62. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  63. package/dist/domains/comet-native/native-cli.js +6 -493
  64. package/dist/domains/comet-native/native-cli.js.map +1 -1
  65. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  66. package/dist/domains/comet-native/native-continuation.js +18 -5
  67. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  68. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  69. package/dist/domains/comet-native/native-evidence-retention.js +5 -21
  70. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  71. package/dist/domains/comet-native/native-evidence-storage.d.ts +2 -8
  72. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  73. package/dist/domains/comet-native/native-evidence-storage.js +2 -23
  74. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  75. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  76. package/dist/domains/comet-native/native-findings.js +6 -4
  77. package/dist/domains/comet-native/native-findings.js.map +1 -1
  78. package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
  79. package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
  80. package/dist/domains/comet-native/native-repair-integration.js +12 -15
  81. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  82. package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
  83. package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
  84. package/dist/domains/comet-native/native-repair-runtime.js +3 -10
  85. package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
  86. package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
  87. package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
  88. package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
  89. package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
  90. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  91. package/dist/domains/comet-native/native-snapshot.js +0 -77
  92. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  93. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  94. package/dist/domains/comet-native/native-transition-evidence.js +0 -10
  95. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  96. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  97. package/dist/domains/comet-native/native-transitions.js +3 -31
  98. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  99. package/dist/domains/comet-native/native-types.d.ts +1 -16
  100. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  101. package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
  102. package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
  103. package/dist/domains/comet-native/native-verification-evidence.js +13 -301
  104. package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
  105. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +2 -138
  106. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  107. package/dist/domains/comet-native/native-verification-receipt-runtime.js +103 -769
  108. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  109. package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
  110. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
  111. package/dist/domains/comet-native/native-verification-receipt.js +19 -350
  112. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
  113. package/dist/domains/comet-native/native-verification-runtime.d.ts +1 -4
  114. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  115. package/dist/domains/comet-native/native-verification-runtime.js +14 -209
  116. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  117. package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-BXDAG6Qx.js} +1 -1
  118. package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-CjVHPivo.js → architectureDiagram-3BPJPVTR-R2JyCv0i.js} +1 -1
  119. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-STNPWdDl.js} +1 -1
  120. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-Bh-rUIcJ.js} +1 -1
  121. package/dist/domains/dashboard/web/assets/channel-XR_5gd6D.js +1 -0
  122. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-BRhFNAFH.js} +1 -1
  123. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CwA3zkFS.js} +1 -1
  124. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-C1tqAl_E.js} +1 -1
  125. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-DDefBoUS.js} +1 -1
  126. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-Dq-0Yi9D.js} +1 -1
  127. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-DC-MVNgk.js} +1 -1
  128. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-BLWZ8zWd.js} +1 -1
  129. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-DaK5rvZu.js} +1 -1
  130. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CG_TnucZ.js +1 -0
  131. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CG_TnucZ.js +1 -0
  132. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-CZk37fGn.js → cose-bilkent-S5V4N54A-DCPgAyMU.js} +1 -1
  133. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-CBaY4KFj.js} +1 -1
  134. package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-D5BQ0eqN.js → dagre-BM42HDAG-CLKQ6BQM.js} +1 -1
  135. package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-33mXstha.js → diagram-2AECGRRQ-DCup336F.js} +1 -1
  136. package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-BWHCMFvD.js → diagram-5GNKFQAL-DgpDOFTE.js} +1 -1
  137. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-BZcengGf.js} +1 -1
  138. package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-BBlsg7jG.js → diagram-LMA3HP47-DSECilBo.js} +1 -1
  139. package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-CsaFSpHi.js → diagram-OG6HWLK6-3FuzANXW.js} +1 -1
  140. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-BBrwULhs.js} +1 -1
  141. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-DiNn0Yzp.js} +1 -1
  142. package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-D1SQ56fl.js → ganttDiagram-6RSMTGT7-DcvbTHnu.js} +1 -1
  143. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-D4oDMS5x.js → gitGraphDiagram-PVQCEYII-CgCY3MJo.js} +1 -1
  144. package/dist/domains/dashboard/web/assets/index-BR3wUr2k.css +1 -0
  145. package/dist/domains/dashboard/web/assets/{index-Msce_H_q.js → index-CovQUq5W.js} +4 -4
  146. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-BeICn98s.js → infoDiagram-5YYISTIA-hzBGAEue.js} +1 -1
  147. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-DCPPspol.js} +1 -1
  148. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-C_v8b1Os.js} +1 -1
  149. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-CgpE9lG7.js} +1 -1
  150. package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-jSddcREx.js} +1 -1
  151. package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-5Ibr28Ig.js} +4 -4
  152. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-XPCohX0x.js} +1 -1
  153. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-DvhxgQWl.js} +1 -1
  154. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-CCUxdF-S.js} +1 -1
  155. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-FS3TCmdX.js} +1 -1
  156. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-r129rscN.js} +1 -1
  157. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK--DCY0bvU.js} +1 -1
  158. package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CcFBc6qh.js → stateDiagram-AJRCARHV-yHkUByrT.js} +1 -1
  159. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-XHzDdqcm.js +1 -0
  160. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-NlqCuFuo.js} +1 -1
  161. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-B4W_d1Nq.js} +1 -1
  162. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-Bex-_jWd.js} +1 -1
  163. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-CmxeVM2Z.js} +1 -1
  164. package/dist/domains/dashboard/web/index.html +2 -2
  165. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  166. package/dist/domains/skill/platform-install.js +22 -2
  167. package/dist/domains/skill/platform-install.js.map +1 -1
  168. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  169. package/dist/domains/workflow-contract/project-config.js +4 -4
  170. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  171. package/eval/local/tasks/comet-native-workflow/instruction.md +4 -17
  172. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +22 -232
  173. package/eval/local/tests/conftest.py +0 -218
  174. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +0 -163
  175. package/eval/local/tests/scaffold/test_tasks.py +1 -8
  176. package/eval/local/tests/scaffold/test_utils.py +4 -7
  177. package/eval/scaffold/shell/docker.sh +2 -95
  178. package/package.json +1 -1
  179. package/dist/domains/comet-native/native-controller-trust.d.ts +0 -22
  180. package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
  181. package/dist/domains/comet-native/native-controller-trust.js +0 -153
  182. package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
  183. package/dist/domains/comet-native/native-creation-authorization.d.ts +0 -30
  184. package/dist/domains/comet-native/native-creation-authorization.d.ts.map +0 -1
  185. package/dist/domains/comet-native/native-creation-authorization.js +0 -110
  186. package/dist/domains/comet-native/native-creation-authorization.js.map +0 -1
  187. package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
  188. package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
  189. package/dist/domains/comet-native/native-independent-review.js +0 -134
  190. package/dist/domains/comet-native/native-independent-review.js.map +0 -1
  191. package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
  192. package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
  193. package/dist/domains/comet-native/native-review-contract.js +0 -6
  194. package/dist/domains/comet-native/native-review-contract.js.map +0 -1
  195. package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
  196. package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
  197. package/dist/domains/comet-native/native-review-identity.js +0 -209
  198. package/dist/domains/comet-native/native-review-identity.js.map +0 -1
  199. package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
  200. package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
  201. package/dist/domains/comet-native/native-review-signer.js +0 -125
  202. package/dist/domains/comet-native/native-review-signer.js.map +0 -1
  203. package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
  204. package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
  205. package/dist/domains/comet-native/native-review-trust.js +0 -176
  206. package/dist/domains/comet-native/native-review-trust.js.map +0 -1
  207. package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
  208. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
  209. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
  210. package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
  211. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
  212. package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
  213. package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
  214. package/eval/scaffold/shell/native-review-verifier-daemon.mjs +0 -178
@@ -1,37 +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> --creation-authorization <path> [--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.
58
+
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.
60
+
61
+ ### Create a new change
62
+
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.
23
68
 
24
- `new` requires a creation authorization supplied by the owner for that change. The current Agent does not generate authorization or handle private keys. If the external action is missing, preserve the Runtime error and wait for the owner.
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.
25
70
 
26
- `status` and `show` are read-only. `new` and `select` establish the current Native selection. Ask the user when multiple candidates cannot be resolved uniquely.
71
+ ### Correct the specification history
27
72
 
28
- `status <change-name> --details` returns detailed findings and an acceptance page:
73
+ ```text
74
+ comet native spec remove <change-name> <capability>
75
+ comet native spec rebase <change-name> --summary <text>
76
+ ```
29
77
 
30
- - when `findingsTruncated` is true, handle the returned findings and read details again;
31
- - when `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`;
32
- - when a change collection has a non-null `nextCursor`, continue with `--cursor`.
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.
33
79
 
34
- 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.
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.
35
81
 
36
82
  ## Checkpoints and checks
37
83
 
@@ -68,54 +114,12 @@ Manual observation:
68
114
  ```text
69
115
  comet native receipt manual <change-name> \
70
116
  --acceptance <id> \
71
- --responsible <text> \
72
117
  --step <text> \
73
- --observation <text> \
74
- --confirmed
118
+ --observation <text>
75
119
  ```
76
120
 
77
121
  Create receipts only for commands or manual observations that actually occurred. Failed, skipped, blocked, or timed-out results cannot support pass.
78
122
 
79
- ## External review handoff
80
-
81
- A signed-v2 pass may require an implementation attestation, independent review, or waiver. 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.
82
-
83
- Implementation handoff:
84
-
85
- ```text
86
- comet native receipt implement <change-name> prepare \
87
- --identity <implementation-identity> \
88
- --output <preparation.json>
89
-
90
- comet native receipt implement <change-name> finalize \
91
- --preparation <preparation.json> \
92
- --attestation <owner-provided-attestation.json> \
93
- --confirmed
94
- ```
95
-
96
- Independent-review handoff:
97
-
98
- ```text
99
- comet native receipt review <change-name> prepare \
100
- --implementation-receipt <ref> \
101
- --report <verification.md> \
102
- --required-receipt <ref> \
103
- --identity <reviewer-identity> \
104
- [--unified-io-receipt <ref> \
105
- --adversarial-paths-receipt <ref> \
106
- --generated-assets-receipt <ref> \
107
- --lifecycle-eval-receipt <ref>] \
108
- --output <preparation.json>
109
-
110
- comet native receipt review <change-name> finalize \
111
- --preparation <preparation.json> \
112
- --approval <reviewer-provided-approval.json> \
113
- --attestation <reviewer-provided-attestation.json> \
114
- --confirmed
115
- ```
116
-
117
- 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.
118
-
119
123
  ## Phase progression
120
124
 
121
125
  ```text
@@ -126,12 +130,6 @@ comet native next <change-name> --summary <text> \
126
130
  [--allow-partial-scope <sha256> --partial-reason <text> --confirmed] \
127
131
  [--result pass|fail] \
128
132
  [--report <change-relative-path>] \
129
- [--receipt <required-receipt-ref>] \
130
- [--evidence-receipt <acceptance-receipt-ref>]... \
131
- [--waiver <waiver-ref>]... \
132
- [--independent-review-receipt <review-receipt-ref>] \
133
- [--failure-category <token>]... \
134
- [--failed-check <token>]... \
135
133
  [--override-repair <sha256> --override-summary <text>]
136
134
 
137
135
  comet native archive <change-name> --dry-run
@@ -139,9 +137,9 @@ comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
139
137
  ```
140
138
 
141
139
  - Shape: pass `--confirmed` only after the user confirms the final shared understanding.
142
- - Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed.
140
+ - 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`.
143
141
  - 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.
144
- - 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.
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`. 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.
145
143
  - Repair override: use only the signature returned by status and only for one explicit new repair hypothesis.
146
144
  - Archive: dry-run first, then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation.
147
145
 
@@ -48,7 +48,15 @@ After Verify fail returns to Build:
48
48
  3. rerun the relevant validation;
49
49
  4. submit the Verify result again.
50
50
 
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.
51
+ 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.
52
+
53
+ 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:
54
+
55
+ 1. continue trying: increase `native.max_verify_failures` and continue;
56
+ 2. change the confirmed contract: return to Shape, update the brief and complete target specification, and reconfirm;
57
+ 3. stop this repair: preserve the change and current scene without progressing or running Archive.
58
+
59
+ The user chooses only the direction. You update configuration or formal artifacts, read the Runtime signature, and execute the follow-up commands.
52
60
 
53
61
  ## Canonical specification conflict
54
62