@rpamis/comet 0.4.0-beta.11 → 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 (192) 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 +2 -2
  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 +144 -144
  8. package/assets/skills/comet/scripts/comet-hook-router.mjs +174 -156
  9. package/assets/skills/comet/scripts/comet-runtime.mjs +161 -183
  10. package/assets/skills/comet-native/SKILL.md +19 -21
  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 +64 -64
  14. package/assets/skills/comet-native/reference/recovery.md +9 -1
  15. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +2315 -5157
  16. package/assets/skills-zh/comet/SKILL.md +8 -4
  17. package/assets/skills-zh/comet/reference/classic-layout.md +2 -2
  18. package/assets/skills-zh/comet-native/SKILL.md +19 -21
  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 +64 -64
  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/config/repository-layout.json +1 -4
  32. package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
  33. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
  34. package/dist/domains/comet-classic/classic-root-command.js +159 -49
  35. package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
  36. package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
  37. package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
  38. package/dist/domains/comet-classic/classic-root-move.js +24 -121
  39. package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
  40. package/dist/domains/comet-entry/current-selection-repair.js +1 -1
  41. package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
  42. package/dist/domains/comet-entry/hook-router.d.ts +12 -2
  43. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  44. package/dist/domains/comet-entry/hook-router.js +40 -14
  45. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  46. package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
  47. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  48. package/dist/domains/comet-native/native-acceptance.js +5 -29
  49. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  50. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  51. package/dist/domains/comet-native/native-cli.js +5 -448
  52. package/dist/domains/comet-native/native-cli.js.map +1 -1
  53. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  54. package/dist/domains/comet-native/native-continuation.js +18 -5
  55. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  56. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  57. package/dist/domains/comet-native/native-evidence-retention.js +5 -21
  58. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  59. package/dist/domains/comet-native/native-evidence-storage.d.ts +2 -8
  60. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  61. package/dist/domains/comet-native/native-evidence-storage.js +2 -23
  62. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  63. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  64. package/dist/domains/comet-native/native-findings.js +6 -4
  65. package/dist/domains/comet-native/native-findings.js.map +1 -1
  66. package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
  67. package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
  68. package/dist/domains/comet-native/native-repair-integration.js +12 -15
  69. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  70. package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
  71. package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
  72. package/dist/domains/comet-native/native-repair-runtime.js +3 -10
  73. package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
  74. package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
  75. package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
  76. package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
  77. package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
  78. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  79. package/dist/domains/comet-native/native-snapshot.js +0 -40
  80. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  81. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  82. package/dist/domains/comet-native/native-transition-evidence.js +0 -10
  83. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  84. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  85. package/dist/domains/comet-native/native-transitions.js +3 -31
  86. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  87. package/dist/domains/comet-native/native-types.d.ts +0 -6
  88. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  89. package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
  90. package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
  91. package/dist/domains/comet-native/native-verification-evidence.js +13 -301
  92. package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
  93. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +2 -138
  94. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
  95. package/dist/domains/comet-native/native-verification-receipt-runtime.js +103 -769
  96. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
  97. package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
  98. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
  99. package/dist/domains/comet-native/native-verification-receipt.js +19 -350
  100. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
  101. package/dist/domains/comet-native/native-verification-runtime.d.ts +1 -4
  102. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  103. package/dist/domains/comet-native/native-verification-runtime.js +14 -209
  104. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  105. package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-BXDAG6Qx.js} +1 -1
  106. package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-CjVHPivo.js → architectureDiagram-3BPJPVTR-R2JyCv0i.js} +1 -1
  107. package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-STNPWdDl.js} +1 -1
  108. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-Bh-rUIcJ.js} +1 -1
  109. package/dist/domains/dashboard/web/assets/channel-XR_5gd6D.js +1 -0
  110. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-BRhFNAFH.js} +1 -1
  111. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CwA3zkFS.js} +1 -1
  112. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-C1tqAl_E.js} +1 -1
  113. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-DDefBoUS.js} +1 -1
  114. package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-Dq-0Yi9D.js} +1 -1
  115. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-DC-MVNgk.js} +1 -1
  116. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-BLWZ8zWd.js} +1 -1
  117. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-DaK5rvZu.js} +1 -1
  118. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CG_TnucZ.js +1 -0
  119. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CG_TnucZ.js +1 -0
  120. package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-CZk37fGn.js → cose-bilkent-S5V4N54A-DCPgAyMU.js} +1 -1
  121. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-CBaY4KFj.js} +1 -1
  122. package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-D5BQ0eqN.js → dagre-BM42HDAG-CLKQ6BQM.js} +1 -1
  123. package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-33mXstha.js → diagram-2AECGRRQ-DCup336F.js} +1 -1
  124. package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-BWHCMFvD.js → diagram-5GNKFQAL-DgpDOFTE.js} +1 -1
  125. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-BZcengGf.js} +1 -1
  126. package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-BBlsg7jG.js → diagram-LMA3HP47-DSECilBo.js} +1 -1
  127. package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-CsaFSpHi.js → diagram-OG6HWLK6-3FuzANXW.js} +1 -1
  128. package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-BBrwULhs.js} +1 -1
  129. package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-DiNn0Yzp.js} +1 -1
  130. package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-D1SQ56fl.js → ganttDiagram-6RSMTGT7-DcvbTHnu.js} +1 -1
  131. package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-D4oDMS5x.js → gitGraphDiagram-PVQCEYII-CgCY3MJo.js} +1 -1
  132. package/dist/domains/dashboard/web/assets/index-BR3wUr2k.css +1 -0
  133. package/dist/domains/dashboard/web/assets/{index-Msce_H_q.js → index-CovQUq5W.js} +4 -4
  134. package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-BeICn98s.js → infoDiagram-5YYISTIA-hzBGAEue.js} +1 -1
  135. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-DCPPspol.js} +1 -1
  136. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-C_v8b1Os.js} +1 -1
  137. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-CgpE9lG7.js} +1 -1
  138. package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-jSddcREx.js} +1 -1
  139. package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-5Ibr28Ig.js} +4 -4
  140. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-XPCohX0x.js} +1 -1
  141. package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-DvhxgQWl.js} +1 -1
  142. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-CCUxdF-S.js} +1 -1
  143. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-FS3TCmdX.js} +1 -1
  144. package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-r129rscN.js} +1 -1
  145. package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK--DCY0bvU.js} +1 -1
  146. package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CcFBc6qh.js → stateDiagram-AJRCARHV-yHkUByrT.js} +1 -1
  147. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-XHzDdqcm.js +1 -0
  148. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-NlqCuFuo.js} +1 -1
  149. package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-B4W_d1Nq.js} +1 -1
  150. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-Bex-_jWd.js} +1 -1
  151. package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-CmxeVM2Z.js} +1 -1
  152. package/dist/domains/dashboard/web/index.html +2 -2
  153. package/eval/local/tasks/comet-native-workflow/instruction.md +4 -16
  154. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +21 -231
  155. package/eval/local/tests/conftest.py +0 -193
  156. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +0 -148
  157. package/eval/local/tests/scaffold/test_tasks.py +1 -8
  158. package/eval/local/tests/scaffold/test_utils.py +4 -7
  159. package/eval/scaffold/shell/docker.sh +2 -95
  160. package/package.json +1 -1
  161. package/dist/domains/comet-native/native-controller-trust.d.ts +0 -21
  162. package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
  163. package/dist/domains/comet-native/native-controller-trust.js +0 -140
  164. package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
  165. package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
  166. package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
  167. package/dist/domains/comet-native/native-independent-review.js +0 -134
  168. package/dist/domains/comet-native/native-independent-review.js.map +0 -1
  169. package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
  170. package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
  171. package/dist/domains/comet-native/native-review-contract.js +0 -6
  172. package/dist/domains/comet-native/native-review-contract.js.map +0 -1
  173. package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
  174. package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
  175. package/dist/domains/comet-native/native-review-identity.js +0 -209
  176. package/dist/domains/comet-native/native-review-identity.js.map +0 -1
  177. package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
  178. package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
  179. package/dist/domains/comet-native/native-review-signer.js +0 -125
  180. package/dist/domains/comet-native/native-review-signer.js.map +0 -1
  181. package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
  182. package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
  183. package/dist/domains/comet-native/native-review-trust.js +0 -176
  184. package/dist/domains/comet-native/native-review-trust.js.map +0 -1
  185. package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
  186. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
  187. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
  188. package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
  189. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
  190. package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
  191. package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
  192. package/eval/scaffold/shell/native-review-verifier-daemon.mjs +0 -178
@@ -1,35 +1,83 @@
1
1
  # Native Command Reference
2
2
 
3
- Read this file only when you need options not listed by the main Skill, receipts, partial scope, an external-role handoff, or recovery commands.
3
+ Read this file only when you need options not listed by the main Skill, receipts, partial scope, or recovery commands.
4
4
 
5
5
  ## Project and change
6
6
 
7
+ Determine the current intent first; do not execute this section from top to bottom. Use read-only commands to establish facts, and run a write command only when its stated condition is met. After any write command, immediately reread `status <change-name>` and use the returned phase and continuation to decide what comes next.
8
+
9
+ ### Enable Native for the first time
10
+
7
11
  ```text
8
12
  comet native init [--root <artifact-root>] [--language en|zh-CN]
13
+ ```
14
+
15
+ Use this only when the project has not enabled Native yet or when Native directories and language configuration need to be completed. It creates the required directories and writes `.comet/config.yaml`. Existing configuration keeps its current artifact root but may update the language. `init` does not migrate an existing artifact root; the command fails when an explicit `--root` conflicts with existing configuration.
16
+
17
+ Afterward, run `root show` to confirm the effective location. Do not use `init` as a resume command when a change already exists.
18
+
19
+ ### Inspect or migrate the artifact root
20
+
21
+ ```text
9
22
  comet native root show
10
23
  comet native root move <artifact-root>
24
+ ```
11
25
 
12
- comet native new <change-name> [--language en|zh-CN]
13
- comet native list [--cursor <token>]
14
- comet native show <change-name>
26
+ `artifact-root` is project-relative.
27
+
28
+ - `root show` is read-only. It returns the project root, configured artifact root, effective Native directory, language, and any unfinished migration.
29
+ - `root move` is a transactional write operation. Run it only when the user explicitly wants to migrate the entire Native artifact root; it moves Native data and updates configuration. Do not simulate migration by editing configuration directly.
30
+
31
+ An unfinished migration blocks other Native writes. Run read-only `doctor` first, then follow its report and use `doctor --repair` to recover.
32
+
33
+ ### Discover and read changes (read-only)
34
+
35
+ ```text
15
36
  comet native status [--cursor <token>]
16
37
  comet native status <change-name> [--details [--acceptance-cursor <token>]]
38
+ comet native show <change-name>
39
+ ```
40
+
41
+ `status` without a change name returns paginated candidates. When multiple reasonable candidates remain, show the candidates and their phases to the user and ask them to choose. Do not guess.
42
+
43
+ - `status <change-name>` returns the phase, revision, check summary, next command, and continuation. Add `--details` when findings, checkpoint details, or acceptance items are needed.
44
+ - `show` returns state, the brief, and proposed specs. Use it only after identifying the target change to read requirements and specifications; it does not replace the phase and continuation check.
45
+ - When `findingsTruncated` is true, handle the returned findings and read details again.
46
+ - When `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`.
47
+ - When a change collection has a non-null `nextCursor`, continue with `--cursor`.
48
+
49
+ These commands do not modify selection, phase, or change content.
50
+
51
+ ### Resume an existing change
52
+
53
+ ```text
17
54
  comet native select <change-name>
18
- comet native spec remove <change-name> <capability>
19
- comet native spec rebase <change-name> --summary <text>
20
55
  ```
21
56
 
22
- `artifact-root` is project-relative. `new` creates default configuration and `<project>/docs/comet/` when configuration is absent. Use `root move` to migrate an existing root; do not edit configuration directly.
57
+ Run this only after the target change is unique or the user has explicitly selected it. `select` updates only the current Native selection and does not change the phase. A successful result returns that change's continuation.
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.
68
+
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.
23
70
 
24
- `status` and `show` are read-only. `new` and `select` establish the current Native selection. Ask the user when multiple candidates cannot be resolved uniquely.
71
+ ### Correct the specification history
25
72
 
26
- `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
+ ```
27
77
 
28
- - when `findingsTruncated` is true, handle the returned findings and read details again;
29
- - when `acceptancePage.nextCursor` is non-null, continue with `--acceptance-cursor`;
30
- - when a change collection has a non-null `nextCursor`, continue with `--cursor`.
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.
31
79
 
32
- When concurrent canonical changes cause a conflict, reread and rewrite the complete target specification before running `spec rebase`. Do not edit operations or hashes manually.
80
+ Both `spec remove` and `spec rebase` modify the change's specification history and return a new continuation. Immediately reread `status <change-name>` afterward. Do not edit operations, base hashes, or Runtime state manually.
33
81
 
34
82
  ## Checkpoints and checks
35
83
 
@@ -66,54 +114,12 @@ Manual observation:
66
114
  ```text
67
115
  comet native receipt manual <change-name> \
68
116
  --acceptance <id> \
69
- --responsible <text> \
70
117
  --step <text> \
71
- --observation <text> \
72
- --confirmed
118
+ --observation <text>
73
119
  ```
74
120
 
75
121
  Create receipts only for commands or manual observations that actually occurred. Failed, skipped, blocked, or timed-out results cannot support pass.
76
122
 
77
- ## External review handoff
78
-
79
- A high-risk change may require an implementation attestation, independent review, or waiver before it can pass. The current Agent may prepare and finalize handoff artifacts, but must not perform an external role's approve or sign action or receive its private key.
80
-
81
- Implementation handoff:
82
-
83
- ```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
92
- ```
93
-
94
- Independent-review handoff:
95
-
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
- ```
114
-
115
- The external role completes approval or signing from the preparation and returns only public artifacts. When the Runtime requires a waiver, an external waiver signer also executes the command supplied by the continuation; the current Agent submits only the returned waiver ref.
116
-
117
123
  ## Phase progression
118
124
 
119
125
  ```text
@@ -124,12 +130,6 @@ comet native next <change-name> --summary <text> \
124
130
  [--allow-partial-scope <sha256> --partial-reason <text> --confirmed] \
125
131
  [--result pass|fail] \
126
132
  [--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
133
  [--override-repair <sha256> --override-summary <text>]
134
134
 
135
135
  comet native archive <change-name> --dry-run
@@ -137,9 +137,9 @@ comet native archive <change-name> --expect-preflight <sha256> [--confirmed]
137
137
  ```
138
138
 
139
139
  - Shape: pass `--confirmed` only after the user confirms the final shared understanding.
140
- - Build: provide a real `--artifact`; use `--no-code-reason` only when no project file changed.
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`.
141
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.
142
- - Verify: provide `--result` and a complete report. For the standard report path, submit `comet native next <change-name> --summary <summary> --result pass|fail --report verification.md`; pass requires current receipts requested by the Runtime, and fail uses stable, non-sensitive failure categories and check IDs.
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.
143
143
  - Repair override: use only the signature returned by status and only for one explicit new repair hypothesis.
144
144
  - Archive: dry-run first, then use the exact preflight hash returned by that preview. `required` mode also requires explicit user confirmation.
145
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