spec-manager 0.1.0
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/AGENTS.md +27 -0
- package/CODEBUDDY.md +19 -0
- package/LICENSE +21 -0
- package/README.md +531 -0
- package/dist/cli/audit.d.ts +10 -0
- package/dist/cli/audit.d.ts.map +1 -0
- package/dist/cli/audit.js +62 -0
- package/dist/cli/audit.js.map +1 -0
- package/dist/cli/change.d.ts +10 -0
- package/dist/cli/change.d.ts.map +1 -0
- package/dist/cli/change.js +103 -0
- package/dist/cli/change.js.map +1 -0
- package/dist/cli/common.d.ts +5 -0
- package/dist/cli/common.d.ts.map +1 -0
- package/dist/cli/common.js +17 -0
- package/dist/cli/common.js.map +1 -0
- package/dist/cli/decision.d.ts +13 -0
- package/dist/cli/decision.d.ts.map +1 -0
- package/dist/cli/decision.js +185 -0
- package/dist/cli/decision.js.map +1 -0
- package/dist/cli/dict.d.ts +10 -0
- package/dist/cli/dict.d.ts.map +1 -0
- package/dist/cli/dict.js +73 -0
- package/dist/cli/dict.js.map +1 -0
- package/dist/cli/incident.d.ts +10 -0
- package/dist/cli/incident.d.ts.map +1 -0
- package/dist/cli/incident.js +119 -0
- package/dist/cli/incident.js.map +1 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +30 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/project.d.ts +3 -0
- package/dist/cli/project.d.ts.map +1 -0
- package/dist/cli/project.js +144 -0
- package/dist/cli/project.js.map +1 -0
- package/dist/cli/spec.d.ts +3 -0
- package/dist/cli/spec.d.ts.map +1 -0
- package/dist/cli/spec.js +289 -0
- package/dist/cli/spec.js.map +1 -0
- package/dist/cli/task.d.ts +14 -0
- package/dist/cli/task.d.ts.map +1 -0
- package/dist/cli/task.js +287 -0
- package/dist/cli/task.js.map +1 -0
- package/dist/cli/usability.d.ts +3 -0
- package/dist/cli/usability.d.ts.map +1 -0
- package/dist/cli/usability.js +153 -0
- package/dist/cli/usability.js.map +1 -0
- package/dist/core/agents.d.ts +43 -0
- package/dist/core/agents.d.ts.map +1 -0
- package/dist/core/agents.js +194 -0
- package/dist/core/agents.js.map +1 -0
- package/dist/core/archive.d.ts +35 -0
- package/dist/core/archive.d.ts.map +1 -0
- package/dist/core/archive.js +360 -0
- package/dist/core/archive.js.map +1 -0
- package/dist/core/audit-events.d.ts +12 -0
- package/dist/core/audit-events.d.ts.map +1 -0
- package/dist/core/audit-events.js +16 -0
- package/dist/core/audit-events.js.map +1 -0
- package/dist/core/audit.d.ts +78 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +157 -0
- package/dist/core/audit.js.map +1 -0
- package/dist/core/constants.d.ts +28 -0
- package/dist/core/constants.d.ts.map +1 -0
- package/dist/core/constants.js +30 -0
- package/dist/core/constants.js.map +1 -0
- package/dist/core/decision.d.ts +69 -0
- package/dist/core/decision.d.ts.map +1 -0
- package/dist/core/decision.js +210 -0
- package/dist/core/decision.js.map +1 -0
- package/dist/core/delta.d.ts +85 -0
- package/dist/core/delta.d.ts.map +1 -0
- package/dist/core/delta.js +264 -0
- package/dist/core/delta.js.map +1 -0
- package/dist/core/dict.d.ts +28 -0
- package/dist/core/dict.d.ts.map +1 -0
- package/dist/core/dict.js +57 -0
- package/dist/core/dict.js.map +1 -0
- package/dist/core/frontmatter.d.ts +19 -0
- package/dist/core/frontmatter.d.ts.map +1 -0
- package/dist/core/frontmatter.js +57 -0
- package/dist/core/frontmatter.js.map +1 -0
- package/dist/core/incident.d.ts +45 -0
- package/dist/core/incident.d.ts.map +1 -0
- package/dist/core/incident.js +128 -0
- package/dist/core/incident.js.map +1 -0
- package/dist/core/paths.d.ts +68 -0
- package/dist/core/paths.d.ts.map +1 -0
- package/dist/core/paths.js +162 -0
- package/dist/core/paths.js.map +1 -0
- package/dist/core/repository.d.ts +13 -0
- package/dist/core/repository.d.ts.map +1 -0
- package/dist/core/repository.js +29 -0
- package/dist/core/repository.js.map +1 -0
- package/dist/core/spec-io.d.ts +125 -0
- package/dist/core/spec-io.d.ts.map +1 -0
- package/dist/core/spec-io.js +260 -0
- package/dist/core/spec-io.js.map +1 -0
- package/dist/core/status.d.ts +22 -0
- package/dist/core/status.d.ts.map +1 -0
- package/dist/core/status.js +54 -0
- package/dist/core/status.js.map +1 -0
- package/dist/core/task.d.ts +118 -0
- package/dist/core/task.d.ts.map +1 -0
- package/dist/core/task.js +340 -0
- package/dist/core/task.js.map +1 -0
- package/dist/core/usability.d.ts +25 -0
- package/dist/core/usability.d.ts.map +1 -0
- package/dist/core/usability.js +136 -0
- package/dist/core/usability.js.map +1 -0
- package/dist/core/validate.d.ts +34 -0
- package/dist/core/validate.d.ts.map +1 -0
- package/dist/core/validate.js +195 -0
- package/dist/core/validate.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +12 -0
- package/dist/index.js.map +1 -0
- package/dist/schemas/change.d.ts +138 -0
- package/dist/schemas/change.d.ts.map +1 -0
- package/dist/schemas/change.js +38 -0
- package/dist/schemas/change.js.map +1 -0
- package/dist/schemas/spec.d.ts +233 -0
- package/dist/schemas/spec.d.ts.map +1 -0
- package/dist/schemas/spec.js +56 -0
- package/dist/schemas/spec.js.map +1 -0
- package/package.json +66 -0
- package/rules/_TEMPLATE.md +20 -0
- package/rules/code-discipline.md +47 -0
- package/rules/codebase-survey.md +37 -0
- package/rules/delta.md +42 -0
- package/rules/doc-governance.md +195 -0
- package/rules/flow-control.md +65 -0
- package/rules/quality-gate.md +73 -0
- package/skill/SKILL.md +90 -0
- package/skill/subskills/adr.md +73 -0
- package/skill/subskills/change.md +118 -0
- package/skill/subskills/design.md +53 -0
- package/skill/subskills/impl.md +100 -0
- package/skill/subskills/plan.md +46 -0
- package/skill/subskills/postmortem.md +77 -0
- package/skill/subskills/prd.md +72 -0
- package/skill/subskills/quick.md +25 -0
- package/skill/subskills/release.md +50 -0
- package/skill/subskills/research.md +35 -0
- package/skill/subskills/runbook.md +44 -0
- package/skill/subskills/testplan.md +48 -0
- package/templates/L0-prd.md +43 -0
- package/templates/L1-prd.md +130 -0
- package/templates/L2-design.md +135 -0
- package/templates/L3-impl.md +125 -0
- package/templates/agent-plan.json +17 -0
- package/templates/agents/AGENTS.md +27 -0
- package/templates/agents/CLAUDE.md +11 -0
- package/templates/agents/CODEBUDDY.md +23 -0
- package/templates/agents/codebuddy-skill/SKILL.md +46 -0
- package/templates/decision.md +42 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/cli/audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* change 子命令(OpenSpec 风格 delta):
|
|
3
|
+
* new <name> [--description D]
|
|
4
|
+
* list
|
|
5
|
+
* show <name>
|
|
6
|
+
* archive <name>
|
|
7
|
+
*/
|
|
8
|
+
import { Command } from 'commander';
|
|
9
|
+
export declare function registerChangeCommands(program: Command): void;
|
|
10
|
+
//# sourceMappingURL=change.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/cli/change.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F7D"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* change 子命令(OpenSpec 风格 delta):
|
|
3
|
+
* new <name> [--description D]
|
|
4
|
+
* list
|
|
5
|
+
* show <name>
|
|
6
|
+
* archive <name>
|
|
7
|
+
*/
|
|
8
|
+
import { getPaths } from '../core/paths.js';
|
|
9
|
+
import { createChange, listChanges, getChangeDir, parseDeltaSpec } from '../core/delta.js';
|
|
10
|
+
import { archiveChange } from '../core/archive.js';
|
|
11
|
+
export function registerChangeCommands(program) {
|
|
12
|
+
const change = program
|
|
13
|
+
.command('change')
|
|
14
|
+
.description('Delta change 提案(OpenSpec 风格:proposal + ADDED/MODIFIED/REMOVED/RENAMED)');
|
|
15
|
+
change
|
|
16
|
+
.command('new <name>')
|
|
17
|
+
.description('创建 change 提案目录(changes/<name>/)')
|
|
18
|
+
.option('--description <desc>', '一句话描述(写入 proposal.md)')
|
|
19
|
+
.action((name, opts) => {
|
|
20
|
+
const paths = getPaths();
|
|
21
|
+
const result = createChange({ paths, name, description: opts.description });
|
|
22
|
+
console.log(`✓ Change created: ${result.name}`);
|
|
23
|
+
console.log(` root: ${result.root}`);
|
|
24
|
+
console.log(` proposal: ${result.proposalFile}`);
|
|
25
|
+
console.log('');
|
|
26
|
+
console.log('下一步:');
|
|
27
|
+
console.log(` 1. 编辑 ${result.proposalFile} 填写 why/scope/risk`);
|
|
28
|
+
console.log(` 2. 在 ${result.root}/deltas/ 创建 delta 文件(ADDED/MODIFIED/REMOVED/RENAMED 段)`);
|
|
29
|
+
console.log(` 3. 在 ${result.root}/specs/<topic>/<code>/ 创建新 spec 占位(ADDED 用)`);
|
|
30
|
+
console.log(` 4. spec-manager change archive ${result.name}`);
|
|
31
|
+
});
|
|
32
|
+
change
|
|
33
|
+
.command('list')
|
|
34
|
+
.description('列出活跃 change 提案')
|
|
35
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
36
|
+
.action((opts) => {
|
|
37
|
+
const paths = getPaths();
|
|
38
|
+
const all = listChanges(paths);
|
|
39
|
+
if (opts.json) {
|
|
40
|
+
console.log(JSON.stringify(all, null, 2));
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
if (all.length === 0) {
|
|
44
|
+
console.log('(no active changes)');
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
for (const c of all) {
|
|
48
|
+
console.log(` ${c.name} (created ${c.created || '?'})`);
|
|
49
|
+
}
|
|
50
|
+
});
|
|
51
|
+
change
|
|
52
|
+
.command('show <name>')
|
|
53
|
+
.description('查看 change 详情(含解析后的 delta entries)')
|
|
54
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
55
|
+
.action((name, opts) => {
|
|
56
|
+
const paths = getPaths();
|
|
57
|
+
const dir = getChangeDir(paths, name);
|
|
58
|
+
if (!dir) {
|
|
59
|
+
console.error(`✗ Change not found: ${name}`);
|
|
60
|
+
process.exit(1);
|
|
61
|
+
}
|
|
62
|
+
if (opts.json) {
|
|
63
|
+
const delta = parseDeltaSpec(paths, name);
|
|
64
|
+
console.log(JSON.stringify(delta, null, 2));
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
console.log(`Change: ${name}`);
|
|
68
|
+
console.log(` root: ${dir.root}`);
|
|
69
|
+
console.log(` proposal: ${dir.proposal}`);
|
|
70
|
+
console.log(` delta files: ${dir.deltaFiles.length}`);
|
|
71
|
+
for (const f of dir.deltaFiles)
|
|
72
|
+
console.log(` - ${f}`);
|
|
73
|
+
console.log(` spec files: ${dir.specFiles.length}`);
|
|
74
|
+
for (const f of dir.specFiles)
|
|
75
|
+
console.log(` - ${f}`);
|
|
76
|
+
});
|
|
77
|
+
change
|
|
78
|
+
.command('archive <name>')
|
|
79
|
+
.description('应用 delta 到主 specs/,把 changes/<name>/ 移到 archive/')
|
|
80
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
81
|
+
.action((name, opts) => {
|
|
82
|
+
const paths = getPaths();
|
|
83
|
+
const result = archiveChange(paths, name);
|
|
84
|
+
if (opts.json) {
|
|
85
|
+
console.log(JSON.stringify(result, null, 2));
|
|
86
|
+
return;
|
|
87
|
+
}
|
|
88
|
+
console.log(`✓ Change ${name} archived`);
|
|
89
|
+
console.log(` archived to: ${result.archivedTo}`);
|
|
90
|
+
console.log(` applied: ${result.applied.length}`);
|
|
91
|
+
for (const a of result.applied) {
|
|
92
|
+
const fromTo = a.from && a.to ? ` (${a.from} → ${a.to})` : '';
|
|
93
|
+
console.log(` [${a.op}] ${a.code}${fromTo}`);
|
|
94
|
+
}
|
|
95
|
+
if (result.skipped.length > 0) {
|
|
96
|
+
console.log(` skipped: ${result.skipped.length}`);
|
|
97
|
+
for (const s of result.skipped) {
|
|
98
|
+
console.log(` [${s.op}] ${s.code}: ${s.reason}`);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=change.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"change.js","sourceRoot":"","sources":["../../src/cli/change.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ProjectPaths } from '../core/paths.js';
|
|
2
|
+
export declare function fail(message: string, code?: number): never;
|
|
3
|
+
export declare function requireInitialized(paths: ProjectPaths): void;
|
|
4
|
+
export declare function printPathGroup(label: string, paths: string[]): void;
|
|
5
|
+
//# sourceMappingURL=common.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/cli/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,KAAK,CAGrD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAI5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAInE"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export function fail(message, code = 1) {
|
|
2
|
+
console.error(message);
|
|
3
|
+
process.exit(code);
|
|
4
|
+
}
|
|
5
|
+
export function requireInitialized(paths) {
|
|
6
|
+
if (!paths.isInitialized) {
|
|
7
|
+
fail('✗ 项目未初始化。先跑: spec-manager project init');
|
|
8
|
+
}
|
|
9
|
+
}
|
|
10
|
+
export function printPathGroup(label, paths) {
|
|
11
|
+
if (paths.length === 0)
|
|
12
|
+
return;
|
|
13
|
+
console.log(`${label}:`);
|
|
14
|
+
for (const p of paths)
|
|
15
|
+
console.log(` - ${p}`);
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=common.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/cli/common.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,IAAI,GAAG,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACzB,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAe;IAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACjD,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* decision 子命令:
|
|
3
|
+
* create <spec-code> --topic X --what W [--why Y] [--criteria AC-1,AC-2]
|
|
4
|
+
* list [--topic X] [--criteria AC-1,AC-2] [--include-all]
|
|
5
|
+
* supersede <id> --by <new-id>
|
|
6
|
+
* update <id> [--what W] [--why Y] [--criteria AC-1,AC-2]
|
|
7
|
+
* set-partial <id> --reason "..."
|
|
8
|
+
* show <id>
|
|
9
|
+
* delete <id>
|
|
10
|
+
*/
|
|
11
|
+
import { Command } from 'commander';
|
|
12
|
+
export declare function registerDecisionCommands(program: Command): void;
|
|
13
|
+
//# sourceMappingURL=decision.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/cli/decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgL/D"}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* decision 子命令:
|
|
3
|
+
* create <spec-code> --topic X --what W [--why Y] [--criteria AC-1,AC-2]
|
|
4
|
+
* list [--topic X] [--criteria AC-1,AC-2] [--include-all]
|
|
5
|
+
* supersede <id> --by <new-id>
|
|
6
|
+
* update <id> [--what W] [--why Y] [--criteria AC-1,AC-2]
|
|
7
|
+
* set-partial <id> --reason "..."
|
|
8
|
+
* show <id>
|
|
9
|
+
* delete <id>
|
|
10
|
+
*/
|
|
11
|
+
import { getPaths } from '../core/paths.js';
|
|
12
|
+
import { createDecision, listDecisions, findDecision, supersedeDecision, updateDecision, setDecisionPartial, deleteDecision } from '../core/decision.js';
|
|
13
|
+
import { DecisionInputSchema } from '../schemas/spec.js';
|
|
14
|
+
export function registerDecisionCommands(program) {
|
|
15
|
+
const dec = program
|
|
16
|
+
.command('decision')
|
|
17
|
+
.description('Decision Cards — 为 implemented L1 spec 记录"决定了什么 / 为什么"');
|
|
18
|
+
dec
|
|
19
|
+
.command('create <specCode>')
|
|
20
|
+
.description('为 implemented L1 spec 创建决策卡片(R18)')
|
|
21
|
+
.requiredOption('--topic <topic>', '功能主题')
|
|
22
|
+
.requiredOption('--what <what>', '决定了什么(≤500 字)')
|
|
23
|
+
.option('--why <why>', '为什么(≤500 字)')
|
|
24
|
+
.option('--criteria <list>', '影响的验收标准(逗号分隔,如 AC-1,AC-3)')
|
|
25
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
26
|
+
.action((specCode, opts) => {
|
|
27
|
+
// Zod 校验输入
|
|
28
|
+
const affectedCriteria = opts.criteria
|
|
29
|
+
? opts.criteria.split(',').map(s => s.trim()).filter(Boolean)
|
|
30
|
+
: undefined;
|
|
31
|
+
const parsed = DecisionInputSchema.safeParse({
|
|
32
|
+
topic: opts.topic,
|
|
33
|
+
what: opts.what,
|
|
34
|
+
why: opts.why,
|
|
35
|
+
affectedCriteria,
|
|
36
|
+
});
|
|
37
|
+
if (!parsed.success) {
|
|
38
|
+
console.error(`✗ 输入非法: ${parsed.error.message}`);
|
|
39
|
+
process.exit(2);
|
|
40
|
+
}
|
|
41
|
+
const paths = getPaths();
|
|
42
|
+
const record = createDecision({
|
|
43
|
+
paths,
|
|
44
|
+
docCode: specCode,
|
|
45
|
+
topic: parsed.data.topic,
|
|
46
|
+
what: parsed.data.what,
|
|
47
|
+
why: parsed.data.why,
|
|
48
|
+
affectedCriteria: parsed.data.affectedCriteria,
|
|
49
|
+
});
|
|
50
|
+
if (opts.json) {
|
|
51
|
+
console.log(JSON.stringify(record, null, 2));
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
console.log(`✓ Decision ${record.id} created for ${specCode}`);
|
|
55
|
+
console.log(` file: ${record.filePath}`);
|
|
56
|
+
console.log(` what: ${record.fm.what.slice(0, 60)}${record.fm.what.length > 60 ? '...' : ''}`);
|
|
57
|
+
});
|
|
58
|
+
dec
|
|
59
|
+
.command('list')
|
|
60
|
+
.description('列出决策卡片(默认仅 active)')
|
|
61
|
+
.option('--topic <topic>', '按 topic 过滤')
|
|
62
|
+
.option('--doc-code <specCode>', '按关联 spec code 过滤(task complete R18 自检用)')
|
|
63
|
+
.option('--criteria <list>', '按 affectedCriteria 过滤(逗号分隔,如 AC-1,AC-3)')
|
|
64
|
+
.option('--include-all', '包含 superseded/partial 状态的', false)
|
|
65
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
66
|
+
.action((opts) => {
|
|
67
|
+
const paths = getPaths();
|
|
68
|
+
const all = listDecisions(paths, {
|
|
69
|
+
topic: opts.topic,
|
|
70
|
+
docCode: opts.docCode,
|
|
71
|
+
criteria: opts.criteria,
|
|
72
|
+
includeAll: opts.includeAll,
|
|
73
|
+
});
|
|
74
|
+
if (opts.json) {
|
|
75
|
+
console.log(JSON.stringify(all, null, 2));
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
if (all.length === 0) {
|
|
79
|
+
console.log('(no decisions)');
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
for (const d of all) {
|
|
83
|
+
const status = d.fm.status === 'active' ? '●' : (d.fm.status === 'superseded' ? '○' : '◐');
|
|
84
|
+
const sup = d.fm.supersededById ? ` (→ ${d.fm.supersededById})` : '';
|
|
85
|
+
const ac = d.fm.affectedCriteria && d.fm.affectedCriteria.length > 0
|
|
86
|
+
? ` {${d.fm.affectedCriteria.join(',')}}`
|
|
87
|
+
: '';
|
|
88
|
+
console.log(`${status} ${d.id} [${d.fm.topic}] ${d.fm.what.slice(0, 60)}${d.fm.what.length > 60 ? '...' : ''}${ac}${sup}`);
|
|
89
|
+
}
|
|
90
|
+
});
|
|
91
|
+
dec
|
|
92
|
+
.command('show <id>')
|
|
93
|
+
.description('查看决策详情')
|
|
94
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
95
|
+
.action((id, opts) => {
|
|
96
|
+
const paths = getPaths();
|
|
97
|
+
const d = findDecision(paths, id);
|
|
98
|
+
if (!d) {
|
|
99
|
+
console.error(`✗ Decision not found: ${id}`);
|
|
100
|
+
process.exit(1);
|
|
101
|
+
}
|
|
102
|
+
if (opts.json) {
|
|
103
|
+
console.log(JSON.stringify(d, null, 2));
|
|
104
|
+
return;
|
|
105
|
+
}
|
|
106
|
+
console.log(`# ${d.id} — ${d.fm.what}`);
|
|
107
|
+
console.log('');
|
|
108
|
+
console.log(`关联 spec: ${d.fm.docCode}`);
|
|
109
|
+
console.log(`状态: ${d.fm.status}${d.fm.supersededById ? `(被 ${d.fm.supersededById} 取代)` : ''}`);
|
|
110
|
+
console.log(`创建: ${d.fm.created}`);
|
|
111
|
+
console.log('');
|
|
112
|
+
console.log('## 决定');
|
|
113
|
+
console.log(d.fm.what);
|
|
114
|
+
if (d.fm.why) {
|
|
115
|
+
console.log('');
|
|
116
|
+
console.log('## 为什么');
|
|
117
|
+
console.log(d.fm.why);
|
|
118
|
+
}
|
|
119
|
+
if (d.fm.affectedCriteria && d.fm.affectedCriteria.length > 0) {
|
|
120
|
+
console.log('');
|
|
121
|
+
console.log('## 影响的验收标准');
|
|
122
|
+
for (const c of d.fm.affectedCriteria)
|
|
123
|
+
console.log(`- ${c}`);
|
|
124
|
+
}
|
|
125
|
+
});
|
|
126
|
+
dec
|
|
127
|
+
.command('supersede <oldId>')
|
|
128
|
+
.description('把旧决策标记为 superseded(指向新决策)')
|
|
129
|
+
.requiredOption('--by <newId>', '新决策的 ID')
|
|
130
|
+
.action((oldId, opts) => {
|
|
131
|
+
const paths = getPaths();
|
|
132
|
+
supersedeDecision(paths, oldId, opts.by);
|
|
133
|
+
console.log(`✓ Decision ${oldId} → superseded by ${opts.by}`);
|
|
134
|
+
});
|
|
135
|
+
dec
|
|
136
|
+
.command('update <id>')
|
|
137
|
+
.description('编辑 active 决策的 what/why/affectedCriteria(状态变更走 supersede/set-partial)')
|
|
138
|
+
.option('--what <what>', '新的决定内容(≤500 字)')
|
|
139
|
+
.option('--why <why>', '新的原因(≤500 字)')
|
|
140
|
+
.option('--criteria <list>', '新的影响验收标准(逗号分隔,如 AC-1,AC-3)')
|
|
141
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
142
|
+
.action((id, opts) => {
|
|
143
|
+
const affectedCriteria = opts.criteria
|
|
144
|
+
? opts.criteria.split(',').map(s => s.trim()).filter(Boolean)
|
|
145
|
+
: undefined;
|
|
146
|
+
const paths = getPaths();
|
|
147
|
+
const updated = updateDecision({
|
|
148
|
+
paths,
|
|
149
|
+
id,
|
|
150
|
+
what: opts.what,
|
|
151
|
+
why: opts.why,
|
|
152
|
+
affectedCriteria,
|
|
153
|
+
});
|
|
154
|
+
if (opts.json) {
|
|
155
|
+
console.log(JSON.stringify(updated, null, 2));
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
console.log(`✓ Decision ${updated.id} updated`);
|
|
159
|
+
console.log(` what: ${updated.fm.what.slice(0, 60)}${updated.fm.what.length > 60 ? '...' : ''}`);
|
|
160
|
+
});
|
|
161
|
+
dec
|
|
162
|
+
.command('set-partial <id>')
|
|
163
|
+
.description('把 active 决策标记为 partial(部分失效),需提供 --reason')
|
|
164
|
+
.requiredOption('--reason <reason>', '为什么标 partial(哪些部分失效)')
|
|
165
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
166
|
+
.action((id, opts) => {
|
|
167
|
+
const paths = getPaths();
|
|
168
|
+
const updated = setDecisionPartial({ paths, id, reason: opts.reason });
|
|
169
|
+
if (opts.json) {
|
|
170
|
+
console.log(JSON.stringify(updated, null, 2));
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
console.log(`✓ Decision ${updated.id} → partial`);
|
|
174
|
+
console.log(` reason: ${opts.reason}`);
|
|
175
|
+
});
|
|
176
|
+
dec
|
|
177
|
+
.command('delete <id>')
|
|
178
|
+
.description('删除决策(active 状态;非 active 状态需先恢复或归档)')
|
|
179
|
+
.action((id) => {
|
|
180
|
+
const paths = getPaths();
|
|
181
|
+
deleteDecision(paths, id);
|
|
182
|
+
console.log(`✓ Decision ${id} deleted`);
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
//# sourceMappingURL=decision.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/cli/decision.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dict 子命令(外部系统数据字典):
|
|
3
|
+
* register <table>.<field> --meaning M [--project 1]
|
|
4
|
+
* query <table>.<field>
|
|
5
|
+
* list [<table>]
|
|
6
|
+
* tables
|
|
7
|
+
*/
|
|
8
|
+
import { Command } from 'commander';
|
|
9
|
+
export declare function registerDictCommands(program: Command): void;
|
|
10
|
+
//# sourceMappingURL=dict.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dict.d.ts","sourceRoot":"","sources":["../../src/cli/dict.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE3D"}
|
package/dist/cli/dict.js
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dict 子命令(外部系统数据字典):
|
|
3
|
+
* register <table>.<field> --meaning M [--project 1]
|
|
4
|
+
* query <table>.<field>
|
|
5
|
+
* list [<table>]
|
|
6
|
+
* tables
|
|
7
|
+
*/
|
|
8
|
+
import { getPaths } from '../core/paths.js';
|
|
9
|
+
import { registerField, queryField, listFieldsByTable, listAllTables } from '../core/dict.js';
|
|
10
|
+
export function registerDictCommands(program) {
|
|
11
|
+
const dict = program
|
|
12
|
+
.command('dict')
|
|
13
|
+
.description('数据字典(外部系统 table.field 业务含义,本地 YAML 存储)');
|
|
14
|
+
dict
|
|
15
|
+
.command('register <table.field>')
|
|
16
|
+
.description('注册 table.field 的业务含义')
|
|
17
|
+
.requiredOption('--meaning <meaning>', '业务含义说明')
|
|
18
|
+
.action((tableField, opts) => {
|
|
19
|
+
const [table, field] = tableField.split('.');
|
|
20
|
+
if (!table || !field) {
|
|
21
|
+
console.error('✗ 必须用 <table>.<field> 格式');
|
|
22
|
+
process.exit(2);
|
|
23
|
+
}
|
|
24
|
+
const paths = getPaths();
|
|
25
|
+
registerField(paths, table, field, opts.meaning);
|
|
26
|
+
console.log(`✓ ${table}.${field} registered`);
|
|
27
|
+
});
|
|
28
|
+
dict
|
|
29
|
+
.command('query <table.field>')
|
|
30
|
+
.description('查询 table.field 的业务含义')
|
|
31
|
+
.action((tableField) => {
|
|
32
|
+
const [table, field] = tableField.split('.');
|
|
33
|
+
if (!table || !field) {
|
|
34
|
+
console.error('✗ 必须用 <table>.<field> 格式');
|
|
35
|
+
process.exit(2);
|
|
36
|
+
}
|
|
37
|
+
const paths = getPaths();
|
|
38
|
+
const e = queryField(paths, table, field);
|
|
39
|
+
if (!e) {
|
|
40
|
+
console.log(`(no entry for ${table}.${field})`);
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
console.log(`${e.table}.${e.field}`);
|
|
44
|
+
console.log(` meaning: ${e.meaning}`);
|
|
45
|
+
console.log(` updated: ${e.updated}`);
|
|
46
|
+
});
|
|
47
|
+
dict
|
|
48
|
+
.command('list [table]')
|
|
49
|
+
.description('列出某 table 下的所有 field')
|
|
50
|
+
.action((table) => {
|
|
51
|
+
const paths = getPaths();
|
|
52
|
+
if (!table) {
|
|
53
|
+
// 不传 table → 列所有 table
|
|
54
|
+
const tables = listAllTables(paths);
|
|
55
|
+
if (tables.length === 0) {
|
|
56
|
+
console.log('(no tables)');
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
for (const t of tables)
|
|
60
|
+
console.log(` ${t}`);
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
const fields = listFieldsByTable(paths, table);
|
|
64
|
+
if (fields.length === 0) {
|
|
65
|
+
console.log(`(no fields in ${table})`);
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
for (const f of fields) {
|
|
69
|
+
console.log(` ${f.table}.${f.field} ${f.meaning.slice(0, 60)}${f.meaning.length > 60 ? '...' : ''}`);
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=dict.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dict.js","sourceRoot":"","sources":["../../src/cli/dict.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* incident 子命令:
|
|
3
|
+
* new --rule R1 --severity high --title X [--description D] [--spec S] [--task T]
|
|
4
|
+
* list [--status open]
|
|
5
|
+
* show <id>
|
|
6
|
+
* update <id> --status mitigated|resolved|closed [--note "..."]
|
|
7
|
+
*/
|
|
8
|
+
import { Command } from 'commander';
|
|
9
|
+
export declare function registerIncidentCommands(program: Command): void;
|
|
10
|
+
//# sourceMappingURL=incident.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"incident.d.ts","sourceRoot":"","sources":["../../src/cli/incident.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+G/D"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* incident 子命令:
|
|
3
|
+
* new --rule R1 --severity high --title X [--description D] [--spec S] [--task T]
|
|
4
|
+
* list [--status open]
|
|
5
|
+
* show <id>
|
|
6
|
+
* update <id> --status mitigated|resolved|closed [--note "..."]
|
|
7
|
+
*/
|
|
8
|
+
import { getPaths } from '../core/paths.js';
|
|
9
|
+
import { createIncident, listIncidents, findIncident, updateIncidentStatus } from '../core/incident.js';
|
|
10
|
+
const INCIDENT_STATUSES = ['open', 'mitigated', 'resolved', 'closed'];
|
|
11
|
+
export function registerIncidentCommands(program) {
|
|
12
|
+
const inc = program
|
|
13
|
+
.command('incident')
|
|
14
|
+
.description('Incident 记录(rule 违反时的根因 + 修复 + 复盘)');
|
|
15
|
+
inc
|
|
16
|
+
.command('new')
|
|
17
|
+
.description('创建 incident(写入 .spec-manager/incidents/INC-YYYYMMDD-NNN.md)')
|
|
18
|
+
.requiredOption('--rule <ruleId>', '触发的规则 ID(R1-R24)')
|
|
19
|
+
.requiredOption('--severity <severity>', '严重度: low|medium|high|critical')
|
|
20
|
+
.requiredOption('--title <title>', '一句话标题')
|
|
21
|
+
.option('--description <desc>', '详细描述(触发场景)')
|
|
22
|
+
.option('--spec <specCode>', '关联的 spec')
|
|
23
|
+
.option('--task <taskCode>', '关联的 task')
|
|
24
|
+
.option('--related-decision <list>', '关联的决策卡片(逗号分隔,如 DC-001,DC-002)')
|
|
25
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
26
|
+
.action((opts) => {
|
|
27
|
+
const paths = getPaths();
|
|
28
|
+
const relatedDecisions = opts.relatedDecision
|
|
29
|
+
? opts.relatedDecision.split(',').map(s => s.trim()).filter(Boolean)
|
|
30
|
+
: undefined;
|
|
31
|
+
const result = createIncident({
|
|
32
|
+
paths,
|
|
33
|
+
ruleId: opts.rule,
|
|
34
|
+
severity: opts.severity,
|
|
35
|
+
title: opts.title,
|
|
36
|
+
description: opts.description,
|
|
37
|
+
specCode: opts.spec,
|
|
38
|
+
taskCode: opts.task,
|
|
39
|
+
relatedDecisions,
|
|
40
|
+
});
|
|
41
|
+
if (opts.json) {
|
|
42
|
+
console.log(JSON.stringify(result, null, 2));
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
console.log(`✓ Incident ${result.id} created`);
|
|
46
|
+
console.log(` file: ${result.filePath}`);
|
|
47
|
+
console.log(` rule: ${result.fm.ruleId} | severity: ${result.fm.severity} | status: ${result.fm.status}`);
|
|
48
|
+
if (result.fm.relatedDecisions && result.fm.relatedDecisions.length > 0) {
|
|
49
|
+
console.log(` decisions: ${result.fm.relatedDecisions.join(', ')}`);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
inc
|
|
53
|
+
.command('list')
|
|
54
|
+
.description('列出 incident(按创建时间倒序)')
|
|
55
|
+
.option('--status <status>', '按 status 过滤: open|mitigated|resolved|closed')
|
|
56
|
+
.option('--related-decision <id>', '按关联决策过滤(返回 relatedDecisions 含此 ID 的)')
|
|
57
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
58
|
+
.action((opts) => {
|
|
59
|
+
const paths = getPaths();
|
|
60
|
+
if (opts.status && !INCIDENT_STATUSES.includes(opts.status)) {
|
|
61
|
+
console.error(`✗ --status 非法: ${opts.status}(必须 ${INCIDENT_STATUSES.join('|')})`);
|
|
62
|
+
process.exit(2);
|
|
63
|
+
}
|
|
64
|
+
const all = listIncidents(paths, {
|
|
65
|
+
status: opts.status,
|
|
66
|
+
relatedDecision: opts.relatedDecision,
|
|
67
|
+
});
|
|
68
|
+
if (opts.json) {
|
|
69
|
+
console.log(JSON.stringify(all, null, 2));
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
if (all.length === 0) {
|
|
73
|
+
console.log('(no incidents)');
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
for (const i of all) {
|
|
77
|
+
const sev = i.fm.severity.padEnd(8);
|
|
78
|
+
const st = i.fm.status.padEnd(10);
|
|
79
|
+
const dec = i.fm.relatedDecisions && i.fm.relatedDecisions.length > 0
|
|
80
|
+
? ` {${i.fm.relatedDecisions.join(',')}}`
|
|
81
|
+
: '';
|
|
82
|
+
console.log(` ${i.id} [${sev}] [${st}] ${i.fm.ruleId} ${i.fm.title}${dec}`);
|
|
83
|
+
}
|
|
84
|
+
});
|
|
85
|
+
inc
|
|
86
|
+
.command('show <id>')
|
|
87
|
+
.description('查看 incident 详情')
|
|
88
|
+
.option('--json', '以 JSON 格式输出', false)
|
|
89
|
+
.action((id, opts) => {
|
|
90
|
+
const paths = getPaths();
|
|
91
|
+
const i = findIncident(paths, id);
|
|
92
|
+
if (!i) {
|
|
93
|
+
console.error(`✗ Incident not found: ${id}`);
|
|
94
|
+
process.exit(1);
|
|
95
|
+
}
|
|
96
|
+
if (opts.json) {
|
|
97
|
+
console.log(JSON.stringify(i, null, 2));
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
console.log(`# ${i.id} — ${i.fm.title}`);
|
|
101
|
+
console.log('');
|
|
102
|
+
console.log(`规则: ${i.fm.ruleId} | 严重度: ${i.fm.severity} | 状态: ${i.fm.status}`);
|
|
103
|
+
console.log(`spec: ${i.fm.specCode ?? '-'} task: ${i.fm.taskCode ?? '-'}`);
|
|
104
|
+
console.log(`创建: ${i.fm.created} 更新: ${i.fm.updated}`);
|
|
105
|
+
console.log('');
|
|
106
|
+
console.log(i.content);
|
|
107
|
+
});
|
|
108
|
+
inc
|
|
109
|
+
.command('update <id>')
|
|
110
|
+
.description('更新 incident 状态(推进闭环)')
|
|
111
|
+
.requiredOption('--status <status>', '新状态: open|mitigated|resolved|closed')
|
|
112
|
+
.option('--note <note>', '状态变更说明(追加到正文)')
|
|
113
|
+
.action((id, opts) => {
|
|
114
|
+
const paths = getPaths();
|
|
115
|
+
const updated = updateIncidentStatus(paths, id, opts.status, opts.note);
|
|
116
|
+
console.log(`✓ Incident ${updated.id} → ${updated.fm.status}`);
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=incident.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"incident.js","sourceRoot":"","sources":["../../src/cli/incident.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}
|