@rpamis/comet 0.1.6 → 0.1.8

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.
@@ -14,65 +14,24 @@ description: "Comet 阶段 4:验证与收尾。用 /comet-verify 调用。验
14
14
 
15
15
  ### 0. 入口状态验证(Entry Check)
16
16
 
17
- 在执行任何操作之前,读取并验证当前状态:
17
+ 执行入口验证:
18
18
 
19
- **检查清单:**
20
- 1. `openspec/changes/<name>/.comet.yaml` 存在
21
- 2. `phase` 字段的值为 `"verify"`
22
- 3. `verify_result` 字段为 `"pending"` 或 null(尚未验证通过)
23
-
24
- **验证方式:**
25
- - `cat openspec/changes/<name>/.comet.yaml` 读取全部字段
26
- - 如 `verify_result` 已是 `"pass"`,说明此 change 已验证过
27
-
28
- **失败输出:**
29
- ```
30
- [HARD STOP] Entry check failed for comet-verify
31
- Expected: phase=verify, verify_result=pending|null
32
- Actual: phase=<实际值>, verify_result=<实际值>
33
- Suggestion: Run comet-build first, or this change was already verified.
19
+ ```bash
20
+ COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
21
+ bash "$COMET_STATE" check <name> verify
34
22
  ```
35
23
 
36
- 验证通过后才进入步骤 1
24
+ 验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
37
25
 
38
26
  ### 1. 改动规模评估
39
27
 
40
- 根据以下指标判定改动规模:
41
-
42
- | 指标 | 小(轻量验证) | 大(完整验证) |
43
- |------|---------------|---------------|
44
- | tasks.md 任务数 | ≤ 3 | > 3 |
45
- | 变更文件数(git diff --stat) | ≤ 5 | > 5 |
46
- | 是否有 delta spec | 无 | 有 |
47
- | 是否新增 capability | 否 | 是 |
48
-
49
- **判定规则**:任一指标命中"大" → 完整验证。全部命中"小" → 轻量验证。
50
-
51
- 判定完成后,在 `openspec/changes/<name>/.comet.yaml` 中记录实际验证模式。`verify_mode` 只允许以下值之一:
52
-
53
- - `light`
54
- - `full`
55
-
56
- Few-shot 示例:
57
-
58
- ```yaml
59
- # 全部指标命中“小”
60
- phase: verify
61
- verify_mode: light
62
- verify_result: pending
63
- ```
28
+ 执行规模评估:
64
29
 
65
- ```yaml
66
- # 任一指标命中”大”
67
- phase: verify
68
- verify_mode: full
69
- verify_result: pending
30
+ ```bash
31
+ bash "$COMET_STATE" scale <name>
70
32
  ```
71
33
 
72
- 【写入验证】更新完成后必须验证:
73
- cat openspec/changes/<name>/.comet.yaml
74
- 确认 verify_mode 行的值为 “<light 或 full>”
75
- 如不匹配,重试写入后再次验证。最多重试 2 次,仍失败则报告错误并终止。
34
+ 脚本自动统计任务数、增量规格数、变更文件数,判断使用 light 或 full 验证模式,并设置 verify_mode 字段。
76
35
 
77
36
  ### 2a. 轻量验证(小改动)
78
37
 
@@ -142,20 +101,13 @@ verify_result: pending
142
101
  - `.comet.yaml` 中 `verify_result` 已记录为 `pass`
143
102
  - **阶段守卫**:运行 `bash $COMET_GUARD <change-name> verify`,全部 PASS 后才允许流转
144
103
 
145
- 退出前在 `.comet.yaml` 中合并更新以下字段(保留其他字段不变):
104
+ 退出前运行 guard 自动流转:
146
105
 
147
- ```yaml
148
- phase: archive
149
- verify_result: pass
150
- verified_at: YYYY-MM-DD
106
+ ```bash
107
+ bash $COMET_GUARD <change-name> verify --apply
151
108
  ```
152
109
 
153
- 【写入验证】更新完成后必须验证:
154
- cat openspec/changes/<name>/.comet.yaml
155
- 确认 phase 行的值为 "archive"
156
- 确认 verify_result 行的值为 "pass"
157
- 确认 verified_at 行的值非空(格式为 YYYY-MM-DD)
158
- 如任一字段不匹配,重试写入后再次验证。最多重试 2 次,仍失败则报告错误并终止。
110
+ 状态文件自动更新为 `phase: archive`、`verify_result: pass`、`verified_at: YYYY-MM-DD`。
159
111
 
160
112
  ## 自动流转
161
113
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rpamis/comet",
3
- "version": "0.1.6",
3
+ "version": "0.1.8",
4
4
  "description": "OpenSpec + Superpowers dual-star development workflow",
5
5
  "keywords": [
6
6
  "comet",