@fxri/toolkit 1.1.2 → 1.1.3
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/CHANGELOG.md +8 -0
- package/README.md +10 -0
- package/SPEC.md +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# @fxri/toolkit
|
|
2
2
|
|
|
3
|
+
## 1.1.3
|
|
4
|
+
> 2026-09-03 发布
|
|
5
|
+
|
|
6
|
+
### 🐛 补丁修复
|
|
7
|
+
|
|
8
|
+
- README 与 .tasks/SPEC 文档补充「归档与提交约束」：任务完成后先归档再提交，保证任务记录与代码变更同批入库。
|
|
9
|
+
|
|
3
10
|
## 1.1.2
|
|
4
11
|
> 2026-09-03 发布
|
|
5
12
|
|
|
@@ -8,6 +15,7 @@
|
|
|
8
15
|
- package.json 补充 repository 字段，npm 包详情页展示 GitHub 仓库地址。
|
|
9
16
|
|
|
10
17
|
## 1.1.1
|
|
18
|
+
|
|
11
19
|
> 2026-09-03 发布
|
|
12
20
|
|
|
13
21
|
### 🐛 补丁修复
|
package/README.md
CHANGED
|
@@ -71,6 +71,16 @@ npx toolkit changelog status / publish # 其余 changeset 子命令透传
|
|
|
71
71
|
- **校验与归档**：写入方案文件后执行 `toolkit tasks` 校验总览；任务完成后执行 `toolkit tasks archive` 归档
|
|
72
72
|
- **版本管理**：涉及发版时先 `toolkit changelog` 创建变更集，再 `toolkit changelog version` 发版并格式化 CHANGELOG
|
|
73
73
|
|
|
74
|
+
### 归档与提交约束
|
|
75
|
+
|
|
76
|
+
项目内任务（含 AI 工作流）完成后，遵循**先归档、后提交**的顺序，保证任务记录与代码变更落在**同一个 git 提交**：
|
|
77
|
+
|
|
78
|
+
1. 任务完成后，在任务文件 frontmatter 标记 `status: 已完成` 并填写 `completed` 完成时间
|
|
79
|
+
2. 执行 `toolkit tasks archive` 归档，任务从 `active/` 移入 `archive/`
|
|
80
|
+
3. 归档后再将代码变更与归档文件一起 `git commit`
|
|
81
|
+
|
|
82
|
+
避免两种情形：任务完成但文件长期滞留 `active/` 未归档；或代码已提交、归档又单独形成一条提交记录。
|
|
83
|
+
|
|
74
84
|
## 📚 库 API
|
|
75
85
|
|
|
76
86
|
```typescript
|
package/SPEC.md
CHANGED
|
@@ -83,7 +83,7 @@ scope: app
|
|
|
83
83
|
|
|
84
84
|
## 4. 归档规则
|
|
85
85
|
|
|
86
|
-
1. 归档触发是**人工 /
|
|
86
|
+
1. 归档触发是**人工 / 事件驱动**，非定时任务；常见触发时机为任务完成、相关变更提交版本控制之前，此时应先行归档再提交。
|
|
87
87
|
2. **任务级归档**：`status ∈ {已完成, 已放弃}` 且带 `completed` 的任务可归档。
|
|
88
88
|
3. `待办` / `进行中` / `阻塞` 均不归档。
|
|
89
89
|
4. 归档文件按 `completed` 的日期（`YYYYMMDD`）划分。
|