@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.
- package/README.md +1 -1
- package/assets/manifest.json +1 -1
- package/assets/skills/comet/SKILL.md +8 -4
- package/assets/skills/comet/reference/classic-layout.md +3 -3
- package/assets/skills/comet/rules/comet-workflow-guard.en.md +4 -3
- package/assets/skills/comet/rules/comet-workflow-guard.md +4 -3
- package/assets/skills/comet/scripts/comet-entry-runtime.mjs +145 -145
- package/assets/skills/comet/scripts/comet-hook-router.mjs +353 -1035
- package/assets/skills/comet/scripts/comet-runtime.mjs +164 -186
- package/assets/skills/comet-native/SKILL.md +20 -23
- package/assets/skills/comet-native/reference/artifacts.md +0 -7
- package/assets/skills/comet-native/reference/clarification.md +1 -1
- package/assets/skills/comet-native/reference/commands.md +63 -65
- package/assets/skills/comet-native/reference/recovery.md +9 -1
- package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +2574 -5719
- package/assets/skills-zh/comet/SKILL.md +8 -4
- package/assets/skills-zh/comet/reference/classic-layout.md +3 -3
- package/assets/skills-zh/comet-native/SKILL.md +20 -23
- package/assets/skills-zh/comet-native/reference/artifacts.md +0 -7
- package/assets/skills-zh/comet-native/reference/clarification.md +1 -1
- package/assets/skills-zh/comet-native/reference/commands.md +63 -65
- package/assets/skills-zh/comet-native/reference/recovery.md +9 -1
- package/dist/app/commands/classic.js +2 -2
- package/dist/app/commands/classic.js.map +1 -1
- package/dist/app/commands/dashboard.d.ts.map +1 -1
- package/dist/app/commands/dashboard.js +2 -1
- package/dist/app/commands/dashboard.js.map +1 -1
- package/dist/app/commands/doctor.d.ts.map +1 -1
- package/dist/app/commands/doctor.js +9 -3
- package/dist/app/commands/doctor.js.map +1 -1
- package/dist/app/commands/update.d.ts.map +1 -1
- package/dist/app/commands/update.js +14 -2
- package/dist/app/commands/update.js.map +1 -1
- package/dist/config/repository-layout.json +1 -4
- package/dist/domains/comet-classic/classic-layout-initialization.js +3 -3
- package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
- package/dist/domains/comet-classic/classic-root-command.d.ts +4 -1
- package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-root-command.js +159 -49
- package/dist/domains/comet-classic/classic-root-command.js.map +1 -1
- package/dist/domains/comet-classic/classic-root-move.d.ts +0 -1
- package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-root-move.js +24 -121
- package/dist/domains/comet-classic/classic-root-move.js.map +1 -1
- package/dist/domains/comet-entry/current-selection-repair.js +1 -1
- package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
- package/dist/domains/comet-entry/hook-router.d.ts +12 -2
- package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router.js +40 -14
- package/dist/domains/comet-entry/hook-router.js.map +1 -1
- package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
- package/dist/domains/comet-entry/init-workflow.js +17 -3
- package/dist/domains/comet-entry/init-workflow.js.map +1 -1
- package/dist/domains/comet-native/native-acceptance.d.ts +1 -2
- package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
- package/dist/domains/comet-native/native-acceptance.js +5 -29
- package/dist/domains/comet-native/native-acceptance.js.map +1 -1
- package/dist/domains/comet-native/native-change.d.ts +0 -2
- package/dist/domains/comet-native/native-change.d.ts.map +1 -1
- package/dist/domains/comet-native/native-change.js +8 -104
- package/dist/domains/comet-native/native-change.js.map +1 -1
- package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
- package/dist/domains/comet-native/native-cli.js +6 -493
- package/dist/domains/comet-native/native-cli.js.map +1 -1
- package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-continuation.js +18 -5
- package/dist/domains/comet-native/native-continuation.js.map +1 -1
- package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
- package/dist/domains/comet-native/native-evidence-retention.js +5 -21
- package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
- package/dist/domains/comet-native/native-evidence-storage.d.ts +2 -8
- package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
- package/dist/domains/comet-native/native-evidence-storage.js +2 -23
- package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
- package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
- package/dist/domains/comet-native/native-findings.js +6 -4
- package/dist/domains/comet-native/native-findings.js.map +1 -1
- package/dist/domains/comet-native/native-repair-integration.d.ts +1 -3
- package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-integration.js +12 -15
- package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
- package/dist/domains/comet-native/native-repair-runtime.d.ts +0 -1
- package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-runtime.js +3 -10
- package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-repair-stagnation.d.ts +1 -9
- package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-repair-stagnation.js +4 -14
- package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
- package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
- package/dist/domains/comet-native/native-snapshot.js +0 -77
- package/dist/domains/comet-native/native-snapshot.js.map +1 -1
- package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
- package/dist/domains/comet-native/native-transition-evidence.js +0 -10
- package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
- package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
- package/dist/domains/comet-native/native-transitions.js +3 -31
- package/dist/domains/comet-native/native-transitions.js.map +1 -1
- package/dist/domains/comet-native/native-types.d.ts +1 -16
- package/dist/domains/comet-native/native-types.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-evidence.d.ts +2 -48
- package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-evidence.js +13 -301
- package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +2 -138
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.js +103 -769
- package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt.d.ts +3 -89
- package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt.js +19 -350
- package/dist/domains/comet-native/native-verification-receipt.js.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.d.ts +1 -4
- package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.js +14 -209
- package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
- package/dist/domains/dashboard/web/assets/{arc-BXWNV2Qv.js → arc-BXDAG6Qx.js} +1 -1
- package/dist/domains/dashboard/web/assets/{architectureDiagram-3BPJPVTR-CjVHPivo.js → architectureDiagram-3BPJPVTR-R2JyCv0i.js} +1 -1
- package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-P2PGImSM.js → blockDiagram-GPEHLZMM-STNPWdDl.js} +1 -1
- package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-fTj6Xhs1.js → c4Diagram-AAUBKEIU-Bh-rUIcJ.js} +1 -1
- package/dist/domains/dashboard/web/assets/channel-XR_5gd6D.js +1 -0
- package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BjFDZ5yo.js → chunk-2J33WTMH-BRhFNAFH.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-BAUkbZdT.js → chunk-4BX2VUAB-CwA3zkFS.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-DBmuiYme.js → chunk-55IACEB6-C1tqAl_E.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-Do9ufCgY.js → chunk-727SXJPM-DDefBoUS.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-qRQWlB5d.js → chunk-AQP2D5EJ-Dq-0Yi9D.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-BzDzeJ4_.js → chunk-FMBD7UC4-DC-MVNgk.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-OQcAmIvL.js → chunk-ND2GUHAM-BLWZ8zWd.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-BiRfH4d2.js → chunk-QZHKN3VN-DaK5rvZu.js} +1 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CG_TnucZ.js +1 -0
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CG_TnucZ.js +1 -0
- package/dist/domains/dashboard/web/assets/{cose-bilkent-S5V4N54A-CZk37fGn.js → cose-bilkent-S5V4N54A-DCPgAyMU.js} +1 -1
- package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-B3F-qRTJ.js → cynefin-VYW2F7L2-CBaY4KFj.js} +1 -1
- package/dist/domains/dashboard/web/assets/{dagre-BM42HDAG-D5BQ0eqN.js → dagre-BM42HDAG-CLKQ6BQM.js} +1 -1
- package/dist/domains/dashboard/web/assets/{diagram-2AECGRRQ-33mXstha.js → diagram-2AECGRRQ-DCup336F.js} +1 -1
- package/dist/domains/dashboard/web/assets/{diagram-5GNKFQAL-BWHCMFvD.js → diagram-5GNKFQAL-DgpDOFTE.js} +1 -1
- package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-DrPGimEt.js → diagram-KO2AKTUF-BZcengGf.js} +1 -1
- package/dist/domains/dashboard/web/assets/{diagram-LMA3HP47-BBlsg7jG.js → diagram-LMA3HP47-DSECilBo.js} +1 -1
- package/dist/domains/dashboard/web/assets/{diagram-OG6HWLK6-CsaFSpHi.js → diagram-OG6HWLK6-3FuzANXW.js} +1 -1
- package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-CoB0mzhk.js → erDiagram-TEJ5UH35-BBrwULhs.js} +1 -1
- package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-lT53XfSE.js → flowDiagram-I6XJVG4X-DiNn0Yzp.js} +1 -1
- package/dist/domains/dashboard/web/assets/{ganttDiagram-6RSMTGT7-D1SQ56fl.js → ganttDiagram-6RSMTGT7-DcvbTHnu.js} +1 -1
- package/dist/domains/dashboard/web/assets/{gitGraphDiagram-PVQCEYII-D4oDMS5x.js → gitGraphDiagram-PVQCEYII-CgCY3MJo.js} +1 -1
- package/dist/domains/dashboard/web/assets/index-BR3wUr2k.css +1 -0
- package/dist/domains/dashboard/web/assets/{index-Msce_H_q.js → index-CovQUq5W.js} +4 -4
- package/dist/domains/dashboard/web/assets/{infoDiagram-5YYISTIA-BeICn98s.js → infoDiagram-5YYISTIA-hzBGAEue.js} +1 -1
- package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-Dkspu33d.js → ishikawaDiagram-YF4QCWOH-DCPPspol.js} +1 -1
- package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C-EM1sZl.js → journeyDiagram-JHISSGLW-C_v8b1Os.js} +1 -1
- package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-BTbB0IO2.js → kanban-definition-UN3LZRKU-CgpE9lG7.js} +1 -1
- package/dist/domains/dashboard/web/assets/{linear-Cp0UrqDr.js → linear-jSddcREx.js} +1 -1
- package/dist/domains/dashboard/web/assets/{mermaid.core-CucmqsLW.js → mermaid.core-5Ibr28Ig.js} +4 -4
- package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CjEshF1X.js → mindmap-definition-RKZ34NQL-XPCohX0x.js} +1 -1
- package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DrwFnX1b.js → pieDiagram-4H26LBE5-DvhxgQWl.js} +1 -1
- package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CjG6pBR2.js → quadrantDiagram-W4KKPZXB-CCUxdF-S.js} +1 -1
- package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-BpUQVqCV.js → requirementDiagram-4Y6WPE33-FS3TCmdX.js} +1 -1
- package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-BeGkEvzR.js → sankeyDiagram-5OEKKPKP-r129rscN.js} +1 -1
- package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK-sSTU3MCO.js → sequenceDiagram-3UESZ5HK--DCY0bvU.js} +1 -1
- package/dist/domains/dashboard/web/assets/{stateDiagram-AJRCARHV-CcFBc6qh.js → stateDiagram-AJRCARHV-yHkUByrT.js} +1 -1
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-XHzDdqcm.js +1 -0
- package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-DCN7NjEs.js → timeline-definition-PNZ67QCA-NlqCuFuo.js} +1 -1
- package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-DZAN1_rr.js → vennDiagram-CIIHVFJN-B4W_d1Nq.js} +1 -1
- package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-FfkJfr4C.js → wardleyDiagram-YWT4CUSO-Bex-_jWd.js} +1 -1
- package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CD8B-EmR.js → xychartDiagram-2RQKCTM6-CmxeVM2Z.js} +1 -1
- package/dist/domains/dashboard/web/index.html +2 -2
- package/dist/domains/skill/platform-install.d.ts.map +1 -1
- package/dist/domains/skill/platform-install.js +22 -2
- package/dist/domains/skill/platform-install.js.map +1 -1
- package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
- package/dist/domains/workflow-contract/project-config.js +4 -4
- package/dist/domains/workflow-contract/project-config.js.map +1 -1
- package/eval/local/tasks/comet-native-workflow/instruction.md +4 -17
- package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +22 -232
- package/eval/local/tests/conftest.py +0 -218
- package/eval/local/tests/scaffold/test_native_wave_evaluations.py +0 -163
- package/eval/local/tests/scaffold/test_tasks.py +1 -8
- package/eval/local/tests/scaffold/test_utils.py +4 -7
- package/eval/scaffold/shell/docker.sh +2 -95
- package/package.json +1 -1
- package/dist/domains/comet-native/native-controller-trust.d.ts +0 -22
- package/dist/domains/comet-native/native-controller-trust.d.ts.map +0 -1
- package/dist/domains/comet-native/native-controller-trust.js +0 -153
- package/dist/domains/comet-native/native-controller-trust.js.map +0 -1
- package/dist/domains/comet-native/native-creation-authorization.d.ts +0 -30
- package/dist/domains/comet-native/native-creation-authorization.d.ts.map +0 -1
- package/dist/domains/comet-native/native-creation-authorization.js +0 -110
- package/dist/domains/comet-native/native-creation-authorization.js.map +0 -1
- package/dist/domains/comet-native/native-independent-review.d.ts +0 -28
- package/dist/domains/comet-native/native-independent-review.d.ts.map +0 -1
- package/dist/domains/comet-native/native-independent-review.js +0 -134
- package/dist/domains/comet-native/native-independent-review.js.map +0 -1
- package/dist/domains/comet-native/native-review-contract.d.ts +0 -6
- package/dist/domains/comet-native/native-review-contract.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-contract.js +0 -6
- package/dist/domains/comet-native/native-review-contract.js.map +0 -1
- package/dist/domains/comet-native/native-review-identity.d.ts +0 -50
- package/dist/domains/comet-native/native-review-identity.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-identity.js +0 -209
- package/dist/domains/comet-native/native-review-identity.js.map +0 -1
- package/dist/domains/comet-native/native-review-signer.d.ts +0 -24
- package/dist/domains/comet-native/native-review-signer.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-signer.js +0 -125
- package/dist/domains/comet-native/native-review-signer.js.map +0 -1
- package/dist/domains/comet-native/native-review-trust.d.ts +0 -35
- package/dist/domains/comet-native/native-review-trust.d.ts.map +0 -1
- package/dist/domains/comet-native/native-review-trust.js +0 -176
- package/dist/domains/comet-native/native-review-trust.js.map +0 -1
- package/dist/domains/dashboard/web/assets/channel--JtnhJr8.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BRGmx8Iz.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BRGmx8Iz.js +0 -1
- package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-D5zZYi4x.js +0 -1
- package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-review-fixture +0 -1
- package/eval/scaffold/shell/native-review-signer-daemon.mjs +0 -144
- 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,
|
|
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
|
-
|
|
13
|
-
|
|
14
|
-
|
|
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
|
-
|
|
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
|
-
`
|
|
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
|
-
|
|
71
|
+
### Correct the specification history
|
|
27
72
|
|
|
28
|
-
|
|
73
|
+
```text
|
|
74
|
+
comet native spec remove <change-name> <capability>
|
|
75
|
+
comet native spec rebase <change-name> --summary <text>
|
|
76
|
+
```
|
|
29
77
|
|
|
30
|
-
- when `
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|