@fxri/toolkit 1.1.1 → 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 CHANGED
@@ -1,6 +1,21 @@
1
1
  # @fxri/toolkit
2
2
 
3
+ ## 1.1.3
4
+ > 2026-09-03 发布
5
+
6
+ ### 🐛 补丁修复
7
+
8
+ - README 与 .tasks/SPEC 文档补充「归档与提交约束」:任务完成后先归档再提交,保证任务记录与代码变更同批入库。
9
+
10
+ ## 1.1.2
11
+ > 2026-09-03 发布
12
+
13
+ ### 🐛 补丁修复
14
+
15
+ - package.json 补充 repository 字段,npm 包详情页展示 GitHub 仓库地址。
16
+
3
17
  ## 1.1.1
18
+
4
19
  > 2026-09-03 发布
5
20
 
6
21
  ### 🐛 补丁修复
@@ -8,6 +23,7 @@
8
23
  - CLI 改用 Commander 实现,新增 --help/--version 与 tasks/changelog 子命令帮助,changelog 透传子命令支持未知选项;commander@^14 作为运行时依赖。
9
24
 
10
25
  ## 1.1.0
26
+
11
27
  > 2026-09-03 发布
12
28
 
13
29
  ### ✨ 新增功能
@@ -15,6 +31,7 @@
15
31
  - 新增隐私脱敏能力:落盘记录自由文本时默认对邮箱、手机号、身份证、IPv4、密钥、JWT、内网 URL 做掩码,支持 --no-redact / FX_REDACT / .toolkitrc.json 三档开关与自定义规则;归档任务改为按完成时间降序并规范化 completed;修复 CHANGELOG 日期补全重复插入。
16
32
 
17
33
  ## 1.0.2
34
+
18
35
  > 2026-09-03 发布
19
36
 
20
37
  ### 🐛 补丁修复
@@ -22,6 +39,7 @@
22
39
  - README 新增「方案落盘(任务区)」章节,明确 npx→ 全局 → 兜底输出的调用优先级,以及 toolkit tasks 校验/归档与 changelog 变更集/发版的使用流程。
23
40
 
24
41
  ## 1.0.1
42
+
25
43
  > 2026-09-02 发布
26
44
 
27
45
  ### 🐛 补丁修复
@@ -34,6 +52,7 @@
34
52
  - 移除公开包元数据中的私有仓库地址
35
53
 
36
54
  ## 1.0.0
55
+
37
56
  > 2026-09-02 发布
38
57
 
39
58
  ### ✨ 新增功能
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`)划分。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fxri/toolkit",
3
- "version": "1.1.1",
3
+ "version": "1.1.3",
4
4
  "description": "开发工程化工具集:任务管理 + 多语言 CHANGELOG 发布。",
5
5
  "license": "MIT",
6
6
  "author": {
@@ -8,6 +8,10 @@
8
8
  "email": "tqy@fxri.net",
9
9
  "url": "https://fxri.net:444/"
10
10
  },
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "https://github.com/fxri-net/toolkit.git"
14
+ },
11
15
  "type": "module",
12
16
  "main": "./dist/index.js",
13
17
  "exports": {