plan-governance-cli 0.3.3 → 0.3.4
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "plan-governance-cli",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.4",
|
|
4
4
|
"description": "统一入口的计划治理检查 CLI",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
@@ -23,7 +23,8 @@
|
|
|
23
23
|
"access": "public"
|
|
24
24
|
},
|
|
25
25
|
"scripts": {
|
|
26
|
-
"test": "node --test tests/npm_cli.test.mjs tests/graph_cli.test.mjs tests/architecture_graph_cli.test.mjs tests/plan_impact_step0.test.mjs tests/plan_impact_cli.test.mjs"
|
|
26
|
+
"test": "node --test tests/npm_cli.test.mjs tests/graph_cli.test.mjs tests/architecture_graph_cli.test.mjs tests/plan_impact_step0.test.mjs tests/plan_impact_cli.test.mjs",
|
|
27
|
+
"release:npm": "node scripts/release_npm.mjs"
|
|
27
28
|
},
|
|
28
29
|
"dependencies": {
|
|
29
30
|
"yaml": "^2.9.0"
|
package/resources/skill/SKILL.md
CHANGED
|
@@ -177,6 +177,14 @@ docs/
|
|
|
177
177
|
|
|
178
178
|
`PLAN_MAP.md` 的计划索引应包含 `最后更新` 列，日期格式为 `YYYY-MM-DD`。
|
|
179
179
|
|
|
180
|
+
计划索引必须在同一个 `## 计划索引` 章节下，按固定顺序拆成三张六列表格：`### 未完成`、`### 已完成`、`### 已废弃`。状态归类规则如下：
|
|
181
|
+
|
|
182
|
+
- `未完成`：`候选`、`设计中`、`待实施`、`实施中`。
|
|
183
|
+
- `已完成`：`已完成`。
|
|
184
|
+
- `已废弃`：`已废弃`、`已替代`、`已合并`等不再推进的终态；表格标题不改变行内真实状态。
|
|
185
|
+
|
|
186
|
+
每个计划只能出现一次；没有对应计划的分类保留表头但不添加占位行。必须使用三级标题，以便治理 CLI 将三张表作为同一个计划索引读取。
|
|
187
|
+
|
|
180
188
|
推荐表头：
|
|
181
189
|
|
|
182
190
|
```markdown
|
|
@@ -11,13 +11,26 @@
|
|
|
11
11
|
- 阶段准入摘要、样本矩阵和独立复核记录只写入专项计划，不复制到本索引。
|
|
12
12
|
- 专项计划可在当前阶段声明阶段证据和追加式实施/验证记录；完成快照默认保持旧 JSON 兼容格式，发布/合规场景再显式使用 purpose 关系。
|
|
13
13
|
- `--drift`/`--pre-commit` 的关闭窗口只在已完成计划自身也发生变更时覆盖该计划自身和显式阶段证据，不复用已完成计划的完整影响范围。
|
|
14
|
+
- 计划索引固定分为 `未完成`、`已完成`、`已废弃` 三张表；`已替代`、`已合并`等不再推进的终态归入 `已废弃` 表，但保留真实状态值。
|
|
14
15
|
|
|
15
16
|
## 计划索引
|
|
16
17
|
|
|
18
|
+
### 未完成
|
|
19
|
+
|
|
17
20
|
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
18
21
|
|---|---|---|---|---|---|
|
|
19
22
|
| [example-plan](plans/example-plan.md) | 候选 | 阶段 0 | <YYYY-MM-DD> | - | - |
|
|
20
23
|
|
|
24
|
+
### 已完成
|
|
25
|
+
|
|
26
|
+
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
27
|
+
|---|---|---|---|---|---|
|
|
28
|
+
|
|
29
|
+
### 已废弃
|
|
30
|
+
|
|
31
|
+
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
32
|
+
|---|---|---|---|---|---|
|
|
33
|
+
|
|
21
34
|
允许状态：`候选`、`设计中`、`待实施`、`实施中`、`已完成`、`已替代`、`已合并`、`已废弃`。
|
|
22
35
|
|
|
23
36
|
## 推荐顺序
|
|
@@ -192,6 +192,10 @@ def update_agent_rules(root):
|
|
|
192
192
|
|
|
193
193
|
def plan_map_content(plan_slug, title, status, phase):
|
|
194
194
|
today = date.today().isoformat()
|
|
195
|
+
row = f"| [{title}](plans/{plan_slug}.md) | {status} | {phase} | {today} | - | - |"
|
|
196
|
+
unfinished_row = row if status in {"候选", "设计中", "待实施", "实施中"} else ""
|
|
197
|
+
completed_row = row if status == "已完成" else ""
|
|
198
|
+
deprecated_row = row if status in {"已废弃", "已替代", "已合并"} else ""
|
|
195
199
|
return f"""# PLAN_MAP
|
|
196
200
|
|
|
197
201
|
## 治理范围
|
|
@@ -208,12 +212,27 @@ def plan_map_content(plan_slug, title, status, phase):
|
|
|
208
212
|
- `PLAN_MAP.md` 的 `状态` 是计划级生命周期，`当前阶段` 是阶段身份指针；阶段 N 完成后，阶段 N+1 默认保持 `设计中`。
|
|
209
213
|
- 阶段准入摘要、样本矩阵和独立复核记录只写入专项计划，不复制到本索引。
|
|
210
214
|
- 启用治理后，已有草案、历史设计、归档计划和临时分析文档默认只作为背景材料，不再作为规范事实源；后续新规范默认进入 `docs/plans/*.md`、ADR、migration、正式 spec 或 `docs/PLAN_MAP.md`。
|
|
215
|
+
- 计划索引固定分为 `未完成`、`已完成`、`已废弃` 三张表；`已替代`、`已合并`等不再推进的终态归入 `已废弃` 表，但保留真实状态值。
|
|
211
216
|
|
|
212
217
|
## 计划索引
|
|
213
218
|
|
|
219
|
+
### 未完成
|
|
220
|
+
|
|
221
|
+
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
222
|
+
|---|---|---|---|---|---|
|
|
223
|
+
{unfinished_row}
|
|
224
|
+
|
|
225
|
+
### 已完成
|
|
226
|
+
|
|
227
|
+
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
228
|
+
|---|---|---|---|---|---|
|
|
229
|
+
{completed_row}
|
|
230
|
+
|
|
231
|
+
### 已废弃
|
|
232
|
+
|
|
214
233
|
| 计划 | 状态 | 当前阶段 | 最后更新 | 依赖 | 证据 |
|
|
215
234
|
|---|---|---|---|---|---|
|
|
216
|
-
|
|
235
|
+
{deprecated_row}
|
|
217
236
|
|
|
218
237
|
允许状态：`候选`、`设计中`、`待实施`、`实施中`、`已完成`、`已替代`、`已合并`、`已废弃`。
|
|
219
238
|
|