paseo-req-kit 1.9.0-beta.3 → 1.9.1
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
|
@@ -2,6 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
每个版本分为"使用者会看到的变化"和"升级须知"。升级步骤见 [docs/guide/安装与升级.md](docs/guide/安装与升级.md)。
|
|
4
4
|
|
|
5
|
+
## 1.9.1
|
|
6
|
+
|
|
7
|
+
1.9 的正式版（1.9.0 的发布任务因一个测试的时序问题失败，没有发布到 npm，内容相同，以 1.9.1 发布）。汇总 1.9.0-beta.1 到 beta.3 的全部内容（各节见下）：本机的需求索引与使用统计、Paseo 插件、外部系统对接。
|
|
8
|
+
|
|
9
|
+
### 使用者会看到的变化
|
|
10
|
+
|
|
11
|
+
- **使用统计**：`req stats` 看本机的需求数、交付周期、返工、等待时长、用时和用量；`--report` 生成给管理方的汇总和明细，`--export` / `--merge` 汇总多台机器。
|
|
12
|
+
- **Paseo 插件**（`req plugin install`）：在 Paseo 的网页端、桌面版和手机上查看本机所有需求的进度、文档（按 Markdown 显示）和统计，确认方案、停止、继续、开始测试验证、同步到外部系统。可以设为只读。
|
|
13
|
+
- **外部系统对接**：配置 `integrations` 后，需求在团队的需求管理系统中自动建卡、跟着阶段改状态；卡片字段在确认需求说明时整理。`req integration test` 预演命令，`req sync` 补发。
|
|
14
|
+
- **`req api`**：给程序用的 JSON 接口，插件通过它工作。
|
|
15
|
+
|
|
16
|
+
### 升级须知
|
|
17
|
+
|
|
18
|
+
- 从 1.8.0 升级：依次看下面 1.9.0-beta.1 到 beta.3 的升级须知。三项新能力都是可选的；升级后在项目目录运行一次 `req index --rebuild`，让之前运行过的需求出现在索引和插件中。
|
|
19
|
+
- 装过插件的，`req upgrade` 会自动把插件换成 1.9.1。
|
|
20
|
+
- 从 1.9.0-beta.3 升级：功能没有变化，只改了版本号和文档中的版本示例。
|
|
21
|
+
|
|
5
22
|
## 1.9.0-beta.3
|
|
6
23
|
|
|
7
24
|
外部系统对接：需求在团队的需求管理系统中自动建卡、跟着阶段改状态；插件中的文档按 Markdown 显示。
|
package/contracts/cli-json.md
CHANGED
|
@@ -64,4 +64,4 @@
|
|
|
64
64
|
| `steps` | 每个步骤一项：`{ key, stepId, title, phase, attempt, round, agentId, startedAt, endedAt, minutes, outcome, result, error, usage }`；`title` 是给人看的名称（如"代码评审（第 2 轮）"），`result` 是结论的文字（如"需要修改"） |
|
|
65
65
|
| `gate` | 质量门：状态文件中的 `gate` |
|
|
66
66
|
| `joint` | 联合需求的其他仓库：`[{ name, slug, repo, sourceRepo, branch, workspaceId, gate }]` |
|
|
67
|
-
| `external` | 外部系统中的卡片（1.9.0
|
|
67
|
+
| `external` | 外部系统中的卡片（1.9.0 起）：`[{ name, id, url, status, syncedAt, pending, lastError }]`；`pending` 是等待补发的调用数 |
|
|
@@ -86,19 +86,19 @@ req doctor --no-project # 体检
|
|
|
86
86
|
**第一步：取得程序。** 把要安装的版本放进它自己的版本目录：
|
|
87
87
|
|
|
88
88
|
```bash
|
|
89
|
-
git clone --branch 1.
|
|
89
|
+
git clone --branch 1.9.1 --depth 1 https://github.com/yiyisf/paseo-req-kit ~/tools/req-kit/versions/1.9.1
|
|
90
90
|
```
|
|
91
91
|
|
|
92
92
|
Windows PowerShell：
|
|
93
93
|
|
|
94
94
|
```powershell
|
|
95
|
-
git clone --branch 1.
|
|
95
|
+
git clone --branch 1.9.1 --depth 1 https://github.com/yiyisf/paseo-req-kit "$env:USERPROFILE\tools\req-kit\versions\1.9.1"
|
|
96
96
|
```
|
|
97
97
|
|
|
98
98
|
**第二步：安装依赖并启用。**
|
|
99
99
|
|
|
100
100
|
```bash
|
|
101
|
-
cd ~/tools/req-kit/versions/1.
|
|
101
|
+
cd ~/tools/req-kit/versions/1.9.1
|
|
102
102
|
npm install
|
|
103
103
|
node install.mjs
|
|
104
104
|
```
|
|
@@ -240,12 +240,12 @@ node bin/req-doctor.mjs --no-project
|
|
|
240
240
|
```bash
|
|
241
241
|
req upgrade --check # 只看有没有新版本
|
|
242
242
|
req upgrade # 升级到最新版本（能支持本机 Paseo 的）
|
|
243
|
-
req upgrade 1.
|
|
243
|
+
req upgrade 1.9.1 # 升级到指定版本
|
|
244
244
|
req upgrade --beta # 当前是正式版时，也考虑 beta 版
|
|
245
245
|
req versions # 已安装的版本和 npm 上的版本
|
|
246
246
|
```
|
|
247
247
|
|
|
248
|
-
- **用 npm 安装的**（1.7.0 起）：从 npm 仓库读取已发布的版本，先读本机 Paseo daemon 的版本，跳过不支持它的 req-kit（每个版本都声明了支持的 Paseo 范围），装进 `versions/<版本>` 后切换。被跳过的版本会说明原因，例如"1.
|
|
248
|
+
- **用 npm 安装的**（1.7.0 起）：从 npm 仓库读取已发布的版本，先读本机 Paseo daemon 的版本，跳过不支持它的 req-kit（每个版本都声明了支持的 Paseo 范围），装进 `versions/<版本>` 后切换。被跳过的版本会说明原因，例如"1.10.0 需要 Paseo >=0.12.0 <0.13.0，本机是 0.11.2"。读不到 daemon 版本时不筛选，升级后请运行 `req doctor`。
|
|
249
249
|
- **用 git 安装的**：读取 git 标签，下载到 `versions/<版本>`，执行 `npm install`，再切换。公司网络只能访问内网镜像时，用 `--from <镜像地址>` 或环境变量 `REQ_KIT_REPO_URL` 指定。想改用 npm 升级时加 `--from npm`。
|
|
250
250
|
- 当前是正式版时只升级到正式版；当前是 beta 时也会升级到更新的 beta。任何一步失败，当前版本不受影响。
|
|
251
251
|
- 也可以按 Paseo 版本直接安装管理器：`npm i -g paseo-req-kit@paseo-0.11`（每个支持的 Paseo 小版本有一个这样的标签）。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "paseo-req-kit",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.1",
|
|
4
4
|
"description": "req-kit: a requirement-development workflow for Paseo. /req aligns a requirement in chat; the engine runs design, implementation, review and verification as Paseo agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -79,7 +79,7 @@ export interface RequirementDetail extends Requirement {
|
|
|
79
79
|
steps: Step[];
|
|
80
80
|
gate: { runs: GateRun[] } | null;
|
|
81
81
|
joint: Array<{ name: string; repo: string; branch: string; workspaceId: string; gate: { runs: GateRun[] } | null }>;
|
|
82
|
-
/** Cards in external systems (req-kit 1.9.0
|
|
82
|
+
/** Cards in external systems (req-kit 1.9.0+; absent before). */
|
|
83
83
|
external?: Array<{ name: string; id: string | null; url: string | null; status: string | null; syncedAt: string | null; pending: number; lastError: string | null }>;
|
|
84
84
|
}
|
|
85
85
|
|