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,30 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Command } from 'commander';
|
|
3
|
+
import { registerProject } from './project.js';
|
|
4
|
+
import { registerSpec } from './spec.js';
|
|
5
|
+
import { registerTaskCommands } from './task.js';
|
|
6
|
+
import { registerDecisionCommands } from './decision.js';
|
|
7
|
+
import { registerAuditCommands } from './audit.js';
|
|
8
|
+
import { registerChangeCommands } from './change.js';
|
|
9
|
+
import { registerIncidentCommands } from './incident.js';
|
|
10
|
+
import { registerDictCommands } from './dict.js';
|
|
11
|
+
import { registerUsabilityCommands } from './usability.js';
|
|
12
|
+
const program = new Command();
|
|
13
|
+
program
|
|
14
|
+
.name('spec-manager')
|
|
15
|
+
.description('spec-manager: local-first spec-driven development platform. Portable CLI + multi-agent instructions.')
|
|
16
|
+
.version('0.1.0');
|
|
17
|
+
registerProject(program);
|
|
18
|
+
registerSpec(program);
|
|
19
|
+
registerTaskCommands(program);
|
|
20
|
+
registerDecisionCommands(program);
|
|
21
|
+
registerAuditCommands(program);
|
|
22
|
+
registerChangeCommands(program);
|
|
23
|
+
registerIncidentCommands(program);
|
|
24
|
+
registerDictCommands(program);
|
|
25
|
+
registerUsabilityCommands(program);
|
|
26
|
+
program.parseAsync(process.argv).catch((e) => {
|
|
27
|
+
console.error('✗ ' + (e?.message ?? e));
|
|
28
|
+
process.exit(1);
|
|
29
|
+
});
|
|
30
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,sGAAsG,CAAC;KACnH,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/cli/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2HtD"}
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { writeFileSync, existsSync, mkdirSync } from 'node:fs';
|
|
2
|
+
import { dirname, join } from 'node:path';
|
|
3
|
+
import { fileURLToPath } from 'node:url';
|
|
4
|
+
import { installAgentSupport, listAgentProviders, parseAgentProviders } from '../core/agents.js';
|
|
5
|
+
import { getPaths } from '../core/paths.js';
|
|
6
|
+
import { listAllSpecs } from '../core/spec-io.js';
|
|
7
|
+
import { runProjectDoctor } from '../core/usability.js';
|
|
8
|
+
import { printPathGroup, requireInitialized } from './common.js';
|
|
9
|
+
export function registerProject(program) {
|
|
10
|
+
const cmd = program.command('project').description('项目管理(init/status)');
|
|
11
|
+
cmd
|
|
12
|
+
.command('init')
|
|
13
|
+
.description('初始化 .spec-manager/ 目录与 config.yaml')
|
|
14
|
+
.option('-n, --name <name>', '项目名称', 'my-project')
|
|
15
|
+
.option('--workflow <workflow>', 'spec workflow 模板', 'default')
|
|
16
|
+
.action((opts) => {
|
|
17
|
+
const paths = getPaths();
|
|
18
|
+
if (existsSync(paths.configDir)) {
|
|
19
|
+
console.log(`✓ 已初始化(${paths.configDir})`);
|
|
20
|
+
return;
|
|
21
|
+
}
|
|
22
|
+
mkdirSync(paths.configDir, { recursive: true });
|
|
23
|
+
mkdirSync(paths.incidentsDir, { recursive: true });
|
|
24
|
+
mkdirSync(paths.specsDir, { recursive: true });
|
|
25
|
+
mkdirSync(paths.changesDir, { recursive: true });
|
|
26
|
+
mkdirSync(paths.archiveDir, { recursive: true });
|
|
27
|
+
const configYaml = [
|
|
28
|
+
`# spec-manager project config`,
|
|
29
|
+
`project_name: ${opts.name}`,
|
|
30
|
+
`specWorkflow: ${opts.workflow}`,
|
|
31
|
+
`# rulesAppliesTo 过滤:留空 = 应用全部 24 条规则`,
|
|
32
|
+
`rulesAppliesTo: []`,
|
|
33
|
+
`created: ${new Date().toISOString()}`,
|
|
34
|
+
``,
|
|
35
|
+
].join('\n');
|
|
36
|
+
writeFileSync(paths.configFile, configYaml, 'utf8');
|
|
37
|
+
writeFileSync(paths.auditFile, initAuditJson(), 'utf8');
|
|
38
|
+
console.log(`✓ 已初始化 ${paths.configDir}`);
|
|
39
|
+
console.log(` - config: ${paths.configFile}`);
|
|
40
|
+
console.log(` - audit: ${paths.auditFile}`);
|
|
41
|
+
console.log(` - specs: ${paths.specsDir}/`);
|
|
42
|
+
console.log(` - changes: ${paths.changesDir}/`);
|
|
43
|
+
console.log(` - archive: ${paths.archiveDir}/`);
|
|
44
|
+
console.log(`\n下一步:spec-manager spec new L1 --topic <topic> --code <CODE> --title "..."`);
|
|
45
|
+
console.log(`AI 配置:spec-manager project agents --provider all`);
|
|
46
|
+
});
|
|
47
|
+
cmd
|
|
48
|
+
.command('agents')
|
|
49
|
+
.description('安装 AI agent 指令与 skill(claude/codex/opencode/codebuddy/all)')
|
|
50
|
+
.option('-p, --provider <provider>', 'list | all | claude | codex | opencode | codebuddy(可逗号组合)', 'all')
|
|
51
|
+
.option('--dry-run', '只显示将写入/覆盖/跳过的文件,不实际落盘')
|
|
52
|
+
.option('--force', '覆盖已存在的 agent 指令文件/skill 目录')
|
|
53
|
+
.action((opts) => {
|
|
54
|
+
if (String(opts.provider).trim().toLowerCase() === 'list') {
|
|
55
|
+
printAgentProviderList();
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
const paths = getPaths();
|
|
59
|
+
const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
|
|
60
|
+
const report = installAgentSupport({
|
|
61
|
+
paths,
|
|
62
|
+
packageRoot,
|
|
63
|
+
providers: parseAgentProviders(opts.provider),
|
|
64
|
+
force: Boolean(opts.force),
|
|
65
|
+
dryRun: Boolean(opts.dryRun),
|
|
66
|
+
});
|
|
67
|
+
const verb = report.dryRun ? 'planned' : 'installed';
|
|
68
|
+
console.log(`✓ AI agent support ${verb}: ${report.providers.join(', ')}`);
|
|
69
|
+
printPathGroup(report.dryRun ? 'would create' : 'created', report.created);
|
|
70
|
+
printPathGroup(report.dryRun ? 'would overwrite' : 'overwritten', report.overwritten);
|
|
71
|
+
printPathGroup('skipped', report.skipped);
|
|
72
|
+
if (report.notes.length > 0) {
|
|
73
|
+
console.log('notes:');
|
|
74
|
+
for (const note of report.notes)
|
|
75
|
+
console.log(` - ${note}`);
|
|
76
|
+
}
|
|
77
|
+
if (!report.dryRun) {
|
|
78
|
+
console.log('');
|
|
79
|
+
console.log('Next:');
|
|
80
|
+
console.log(' Claude / CodeBuddy: /spec-manager add user authentication feature');
|
|
81
|
+
console.log(' Codex / OpenCode: Ask "Use spec-manager to add user authentication feature."');
|
|
82
|
+
console.log(' Verify: spec-manager project doctor');
|
|
83
|
+
}
|
|
84
|
+
});
|
|
85
|
+
cmd
|
|
86
|
+
.command('doctor')
|
|
87
|
+
.description('检查项目初始化、agent 指令、skill 资产、占位 spec 和 audit 状态')
|
|
88
|
+
.action(() => {
|
|
89
|
+
const paths = getPaths();
|
|
90
|
+
const checks = runProjectDoctor(paths);
|
|
91
|
+
for (const check of checks) {
|
|
92
|
+
const mark = check.status === 'ok' ? '✓' : check.status === 'warn' ? '⚠' : '✗';
|
|
93
|
+
console.log(`${mark} ${check.label}: ${check.detail}`);
|
|
94
|
+
if (check.action)
|
|
95
|
+
console.log(` Next: ${check.action}`);
|
|
96
|
+
}
|
|
97
|
+
const hasFail = checks.some((c) => c.status === 'fail');
|
|
98
|
+
const hasWarn = checks.some((c) => c.status === 'warn');
|
|
99
|
+
console.log(hasFail ? '\nProject doctor: failed' : hasWarn ? '\nProject doctor: warnings' : '\nProject doctor: ok');
|
|
100
|
+
});
|
|
101
|
+
cmd
|
|
102
|
+
.command('status')
|
|
103
|
+
.description('项目状态总览:spec 状态分布 / topic 列表 / 任务数')
|
|
104
|
+
.action(() => {
|
|
105
|
+
const paths = getPaths();
|
|
106
|
+
requireInitialized(paths);
|
|
107
|
+
const specs = listAllSpecs(paths);
|
|
108
|
+
const byStatus = {};
|
|
109
|
+
const byTopic = {};
|
|
110
|
+
for (const s of specs) {
|
|
111
|
+
byStatus[s.fm.status] = (byStatus[s.fm.status] ?? 0) + 1;
|
|
112
|
+
byTopic[s.fm.topic] = (byTopic[s.fm.topic] ?? 0) + 1;
|
|
113
|
+
}
|
|
114
|
+
console.log(`📊 项目状态 (root: ${paths.root})\n`);
|
|
115
|
+
console.log('Specs:');
|
|
116
|
+
for (const s of ['draft', 'confirmed', 'frozen', 'implemented', 'archived']) {
|
|
117
|
+
if (byStatus[s])
|
|
118
|
+
console.log(` ${s.padEnd(12)} ${byStatus[s]}`);
|
|
119
|
+
}
|
|
120
|
+
console.log(`\nTopics: ${Object.keys(byTopic).length}`);
|
|
121
|
+
for (const [t, n] of Object.entries(byTopic).sort((a, b) => b[1] - a[1])) {
|
|
122
|
+
console.log(` ${t.padEnd(20)} ${n} spec(s)`);
|
|
123
|
+
}
|
|
124
|
+
if (specs.length === 0) {
|
|
125
|
+
console.log('\n(尚无 spec)');
|
|
126
|
+
}
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
function printAgentProviderList() {
|
|
130
|
+
console.log('Supported AI agent providers:');
|
|
131
|
+
for (const provider of listAgentProviders()) {
|
|
132
|
+
console.log(` - ${provider.provider}`);
|
|
133
|
+
console.log(` aliases: ${provider.aliases.join(', ')}`);
|
|
134
|
+
console.log(` files: ${provider.files.join(', ')}`);
|
|
135
|
+
console.log(` ${provider.description}`);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
function initAuditJson() {
|
|
139
|
+
const rules = {};
|
|
140
|
+
for (let i = 1; i <= 24; i++)
|
|
141
|
+
rules[`R${i}`] = 0;
|
|
142
|
+
return JSON.stringify({ sessionId: '', startedAt: '', topic: '', rules, pending: [], lastUpdated: '' }, null, 2);
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=project.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/cli/project.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/cli/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0RnD"}
|
package/dist/cli/spec.js
ADDED
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { getPaths } from '../core/paths.js';
|
|
3
|
+
import { createSpec, findSpecByCode, generateSpecCode, isPlaceholderContent, listAllSpecs, migrateSpecPaths, updateSpec, DESC_MAX_LEN, } from '../core/spec-io.js';
|
|
4
|
+
import { canTransition, isActiveStatus, nextStatuses } from '../core/status.js';
|
|
5
|
+
import { validateSpecContent, validatePlanJson } from '../core/validate.js';
|
|
6
|
+
import { hit } from '../core/audit.js';
|
|
7
|
+
import { listDecisions } from '../core/decision.js';
|
|
8
|
+
import { suggestAfterSpecCommand } from '../core/usability.js';
|
|
9
|
+
import { fail, requireInitialized } from './common.js';
|
|
10
|
+
export function registerSpec(program) {
|
|
11
|
+
const cmd = program.command('spec').description('Spec 增删改查');
|
|
12
|
+
cmd
|
|
13
|
+
.command('new <level>')
|
|
14
|
+
.description('创建 Spec(L0/L1/L2/L3)。L2/L3 需 --parent。--code 可选,不传自动生成 <topic>-<level>')
|
|
15
|
+
.requiredOption('--topic <topic>', 'topic 名(如 auth)')
|
|
16
|
+
.option('--code <code>', 'spec code(如 auth-L1);不传则自动生成 <topic>-<level>')
|
|
17
|
+
.requiredOption('--title <title>', 'spec 标题')
|
|
18
|
+
.option('--parent <parentCode>', '父 spec code(L2→L1, L3→L2)')
|
|
19
|
+
.option('--desc <desc>', `描述后缀(≤${DESC_MAX_LEN} 字符,如 readme/batch/tests),追加到 code 末尾`)
|
|
20
|
+
.option('--milestone <milestone>', '迭代版本号(如 v1.0 / v1.0-beta)')
|
|
21
|
+
.option('--allow-duplicate-topic', '允许同 topic 下创建额外 L1(已确认不是重复需求)', false)
|
|
22
|
+
.action((level, opts) => {
|
|
23
|
+
if (!['L0', 'L1', 'L2', 'L3'].includes(level)) {
|
|
24
|
+
fail(`✗ level 必须是 L0/L1/L2/L3,收到 "${level}"`, 2);
|
|
25
|
+
}
|
|
26
|
+
const paths = getPaths();
|
|
27
|
+
requireInitialized(paths);
|
|
28
|
+
if ((level === 'L2' || level === 'L3') && !opts.parent) {
|
|
29
|
+
fail(`✗ R7: ${level} 必须有 --parent 指向父 spec code`, 2);
|
|
30
|
+
}
|
|
31
|
+
if (opts.desc) {
|
|
32
|
+
if (opts.desc.length > DESC_MAX_LEN) {
|
|
33
|
+
fail(`✗ --desc 超过 ${DESC_MAX_LEN} 字符(当前 ${opts.desc.length})`, 2);
|
|
34
|
+
}
|
|
35
|
+
if (!/^[a-z0-9-]+$/.test(opts.desc)) {
|
|
36
|
+
fail(`✗ --desc 只允许小写字母、数字、连字符`, 2);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
// 点分编号:统计同父的已有子 spec 数量,用于生成下一个索引
|
|
40
|
+
let siblingCount = 0;
|
|
41
|
+
if (opts.parent) {
|
|
42
|
+
const allSpecs = listAllSpecs(paths);
|
|
43
|
+
siblingCount = allSpecs.filter(s => s.fm.parentCode === opts.parent).length;
|
|
44
|
+
}
|
|
45
|
+
const code = opts.code ?? generateSpecCode(opts.topic, level, opts.parent, siblingCount, opts.desc);
|
|
46
|
+
if (findSpecByCode(paths, code)) {
|
|
47
|
+
fail(`✗ code 重复: ${code}`, 2);
|
|
48
|
+
}
|
|
49
|
+
if (level === 'L1') {
|
|
50
|
+
hit({ paths, ruleId: 'R16', specCode: code });
|
|
51
|
+
const existingL1 = listAllSpecs(paths)
|
|
52
|
+
.filter(s => s.fm.level === 'L1' && s.fm.topic === opts.topic && isActiveStatus(s.fm.status));
|
|
53
|
+
if (existingL1.length > 0 && !opts.allowDuplicateTopic) {
|
|
54
|
+
const decisions = listDecisions(paths, { topic: opts.topic, includeAll: true });
|
|
55
|
+
const lines = [`✗ R16: topic=${opts.topic} 已有 active L1,创建新 L1 前必须先查重`];
|
|
56
|
+
for (const s of existingL1)
|
|
57
|
+
lines.push(` - ${s.fm.code} (${s.fm.status}) ${s.fm.title}`);
|
|
58
|
+
lines.push(` 历史决策: ${decisions.length} 张`);
|
|
59
|
+
lines.push(` 若确认不是重复需求,请加 --allow-duplicate-topic`);
|
|
60
|
+
fail(lines.join('\n'), 2);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
const rec = createSpec({
|
|
64
|
+
paths,
|
|
65
|
+
code,
|
|
66
|
+
level: level,
|
|
67
|
+
title: opts.title,
|
|
68
|
+
topic: opts.topic,
|
|
69
|
+
parentCode: opts.parent ?? null,
|
|
70
|
+
milestone: opts.milestone,
|
|
71
|
+
});
|
|
72
|
+
console.log(`✓ 已创建 ${level} spec`);
|
|
73
|
+
console.log(` code: ${rec.fm.code}`);
|
|
74
|
+
console.log(` file: ${rec.filePath}`);
|
|
75
|
+
console.log(` status: ${rec.fm.status}`);
|
|
76
|
+
if (rec.fm.milestone)
|
|
77
|
+
console.log(` milestone:${rec.fm.milestone}`);
|
|
78
|
+
console.log(`\nNext: ${suggestAfterSpecCommand(rec)}`);
|
|
79
|
+
});
|
|
80
|
+
cmd
|
|
81
|
+
.command('list')
|
|
82
|
+
.description('列出 specs(默认隐藏 archived)')
|
|
83
|
+
.option('--level <level>', '按层过滤 L0/L1/L2/L3')
|
|
84
|
+
.option('--topic <topic>', '按 topic 过滤')
|
|
85
|
+
.option('--status <status>', '按状态过滤 draft/confirmed/frozen/implemented/archived')
|
|
86
|
+
.option('--include-archived', '包含 archived')
|
|
87
|
+
.action((opts) => {
|
|
88
|
+
const paths = getPaths();
|
|
89
|
+
requireInitialized(paths);
|
|
90
|
+
let specs = listAllSpecs(paths);
|
|
91
|
+
if (opts.level)
|
|
92
|
+
specs = specs.filter(s => s.fm.level === opts.level);
|
|
93
|
+
if (opts.topic)
|
|
94
|
+
specs = specs.filter(s => s.fm.topic === opts.topic);
|
|
95
|
+
if (opts.status)
|
|
96
|
+
specs = specs.filter(s => s.fm.status === opts.status);
|
|
97
|
+
if (!opts.includeArchived)
|
|
98
|
+
specs = specs.filter(s => isActiveStatus(s.fm.status));
|
|
99
|
+
specs.sort((a, b) => a.fm.code.localeCompare(b.fm.code));
|
|
100
|
+
if (specs.length === 0) {
|
|
101
|
+
console.log('(无匹配 spec)');
|
|
102
|
+
return;
|
|
103
|
+
}
|
|
104
|
+
console.log(`${'CODE'.padEnd(28)}${'LEVEL'.padEnd(6)}${'STATUS'.padEnd(13)}TOPIC TITLE`);
|
|
105
|
+
console.log('-'.repeat(100));
|
|
106
|
+
for (const s of specs) {
|
|
107
|
+
console.log(`${s.fm.code.padEnd(28)}${s.fm.level.padEnd(6)}${s.fm.status.padEnd(13)}${s.fm.topic.padEnd(13)}${s.fm.title}`);
|
|
108
|
+
}
|
|
109
|
+
console.log(`\n共 ${specs.length} 条`);
|
|
110
|
+
});
|
|
111
|
+
cmd
|
|
112
|
+
.command('show <code>')
|
|
113
|
+
.description('查看 spec 详情。默认窄视图(R19),--include-content 才返回正文。')
|
|
114
|
+
.option('--include-content', '返回完整 contentTemplate(窄视图默认不含)')
|
|
115
|
+
.action((code, opts) => {
|
|
116
|
+
const paths = getPaths();
|
|
117
|
+
const rec = findSpecByCode(paths, code);
|
|
118
|
+
if (!rec) {
|
|
119
|
+
fail(`✗ 未找到: ${code}`);
|
|
120
|
+
}
|
|
121
|
+
const fm = rec.fm;
|
|
122
|
+
console.log('--- metadata ---');
|
|
123
|
+
console.log(`code: ${fm.code}`);
|
|
124
|
+
console.log(`level: ${fm.level}`);
|
|
125
|
+
console.log(`title: ${fm.title}`);
|
|
126
|
+
console.log(`topic: ${fm.topic}`);
|
|
127
|
+
console.log(`parent: ${fm.parentCode ?? '(null)'}`);
|
|
128
|
+
console.log(`status: ${fm.status}`);
|
|
129
|
+
console.log(`aiSummary: ${fm.aiSummary || '(空)'}`);
|
|
130
|
+
console.log(`created: ${fm.created}`);
|
|
131
|
+
console.log(`updated: ${fm.updated}`);
|
|
132
|
+
console.log(`relations: ${fm.relations?.length ?? 0}`);
|
|
133
|
+
if (opts.includeContent) {
|
|
134
|
+
console.log('\n--- content ---');
|
|
135
|
+
console.log(rec.content);
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
hit({ paths, ruleId: 'R19', specCode: code });
|
|
139
|
+
console.log('\n(省略正文;加 --include-content 查看)');
|
|
140
|
+
}
|
|
141
|
+
});
|
|
142
|
+
cmd
|
|
143
|
+
.command('update <code>')
|
|
144
|
+
.description('更新 spec:--content 写正文、--ai-summary 写摘要(≤300 字符)、--change-summary 写变更说明')
|
|
145
|
+
.option('--content <file>', '从文件读 contentTemplate 内容(- 表示 stdin)')
|
|
146
|
+
.option('--ai-summary <s>', 'aiSummary(≤300 字符)')
|
|
147
|
+
.option('--change-summary <s>', '本次修改的原因说明')
|
|
148
|
+
.action((code, opts) => {
|
|
149
|
+
const paths = getPaths();
|
|
150
|
+
const rec = findSpecByCode(paths, code);
|
|
151
|
+
if (!rec) {
|
|
152
|
+
fail(`✗ 未找到: ${code}`);
|
|
153
|
+
}
|
|
154
|
+
const patch = {};
|
|
155
|
+
if (opts.content) {
|
|
156
|
+
patch.content = opts.content === '-' ? readStdin() : readFileSync(opts.content, 'utf8');
|
|
157
|
+
}
|
|
158
|
+
if (opts.aiSummary)
|
|
159
|
+
patch.aiSummary = opts.aiSummary;
|
|
160
|
+
if (opts.changeSummary)
|
|
161
|
+
patch.changeSummary = opts.changeSummary;
|
|
162
|
+
const result = updateSpec(paths, code, patch);
|
|
163
|
+
for (const w of result.warnings)
|
|
164
|
+
console.warn(`⚠ ${w}`);
|
|
165
|
+
// 写完自动跑一次非阻断校验
|
|
166
|
+
const warnings = validateSpecContent(result.record.fm.level, result.record.content);
|
|
167
|
+
for (const w of warnings) {
|
|
168
|
+
const sym = w.level === 'warn' ? '⚠' : 'ℹ';
|
|
169
|
+
console.log(`${sym} [${w.rule}] ${w.message}`);
|
|
170
|
+
}
|
|
171
|
+
console.log(`✓ 已更新 ${code}(status: ${result.record.fm.status})`);
|
|
172
|
+
console.log(`Next: ${suggestAfterSpecCommand(result.record)}`);
|
|
173
|
+
});
|
|
174
|
+
// 状态推进命令
|
|
175
|
+
for (const { cmd: sub, status: target } of [
|
|
176
|
+
{ cmd: 'confirm', status: 'confirmed' },
|
|
177
|
+
{ cmd: 'freeze', status: 'frozen' },
|
|
178
|
+
{ cmd: 'implement', status: 'implemented' },
|
|
179
|
+
]) {
|
|
180
|
+
cmd
|
|
181
|
+
.command(`${sub} <code>`)
|
|
182
|
+
.description(`推进 status 到 ${target}(R2: 仅用户/自动 cascade 触发)`)
|
|
183
|
+
.option('--force', '强制推进(跳过 R3 L3 保护)', false)
|
|
184
|
+
.action((code, opts) => {
|
|
185
|
+
const paths = getPaths();
|
|
186
|
+
const rec = findSpecByCode(paths, code);
|
|
187
|
+
if (!rec) {
|
|
188
|
+
fail(`✗ 未找到: ${code}`);
|
|
189
|
+
}
|
|
190
|
+
// R22: 推进到 confirmed/frozen 之前,contentTemplate 不能只有占位
|
|
191
|
+
if ((target === 'confirmed' || target === 'frozen') && isPlaceholderContent(rec.content)) {
|
|
192
|
+
fail(`✗ R22: ${code} 的 contentTemplate 仍是占位("<!-- 在此粘贴正文 -->")\n` +
|
|
193
|
+
` 请先: spec-manager spec update ${code} --content <file> --ai-summary "..." --change-summary "..."`, 2);
|
|
194
|
+
}
|
|
195
|
+
if (!canTransition(rec.fm.status, target)) {
|
|
196
|
+
fail(`✗ 状态非法: ${rec.fm.status} → ${target}\n 合法的下一态:${nextStatuses(rec.fm.status).join(', ')}`, 2);
|
|
197
|
+
}
|
|
198
|
+
// R3: L3 的 implemented 应由 task cascade 触发,手动推进需 --force
|
|
199
|
+
if (target === 'implemented' && rec.fm.level === 'L3' && rec.fm.status === 'frozen' && !opts.force) {
|
|
200
|
+
fail(`⚠ R3: L3 spec ${code} 的 implemented 应由 task complete 自动 cascade\n` +
|
|
201
|
+
` 如确需手动推进,请用: spec-manager spec implement ${code} --force`, 2);
|
|
202
|
+
}
|
|
203
|
+
hit({ paths, ruleId: 'R2', specCode: code });
|
|
204
|
+
hit({ paths, ruleId: 'R9', specCode: code });
|
|
205
|
+
const { record } = updateSpec(paths, code, { status: target, changeSummary: `${rec.fm.status} → ${target}` });
|
|
206
|
+
console.log(`✓ ${code}: ${rec.fm.status} → ${target}`);
|
|
207
|
+
console.log(`Next: ${suggestAfterSpecCommand(record)}`);
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
cmd
|
|
211
|
+
.command('validate <code>')
|
|
212
|
+
.description('校验 spec 正文(必填段 + RFC 2119)。warning-only,exit 0。')
|
|
213
|
+
.action((code) => {
|
|
214
|
+
const paths = getPaths();
|
|
215
|
+
const rec = findSpecByCode(paths, code);
|
|
216
|
+
if (!rec) {
|
|
217
|
+
fail(`✗ 未找到: ${code}`);
|
|
218
|
+
}
|
|
219
|
+
const warnings = validateSpecContent(rec.fm.level, rec.content);
|
|
220
|
+
if (warnings.length === 0) {
|
|
221
|
+
console.log(`✓ ${code} (${rec.fm.level}): 所有必填段齐全,无 RFC 2119 警告`);
|
|
222
|
+
}
|
|
223
|
+
else {
|
|
224
|
+
for (const w of warnings) {
|
|
225
|
+
const sym = w.level === 'warn' ? '⚠' : 'ℹ';
|
|
226
|
+
console.log(`${sym} [${w.rule}] ${w.message}`);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
});
|
|
230
|
+
cmd
|
|
231
|
+
.command('add-relation <code>')
|
|
232
|
+
.description('添加 spec 关联(基于/替代/实现/参考)')
|
|
233
|
+
.requiredOption('--target <targetCode>', '目标 spec code')
|
|
234
|
+
.requiredOption('--type <type>', '关联类型:based_on | supersedes | implements | references')
|
|
235
|
+
.action((code, opts) => {
|
|
236
|
+
const paths = getPaths();
|
|
237
|
+
if (!['based_on', 'supersedes', 'implements', 'references'].includes(opts.type)) {
|
|
238
|
+
fail(`✗ type 必须是 based_on | supersedes | implements | references`, 2);
|
|
239
|
+
}
|
|
240
|
+
updateSpec(paths, code, { addRelation: { type: opts.type, target: opts.target } });
|
|
241
|
+
console.log(`✓ ${code} --[${opts.type}]--> ${opts.target}`);
|
|
242
|
+
});
|
|
243
|
+
cmd
|
|
244
|
+
.command('migrate-paths')
|
|
245
|
+
.description('迁移 active spec 文件名:<code>-YYYYMMDD.md → <code>.md(读取仍兼容旧格式)')
|
|
246
|
+
.option('--dry-run', '只显示迁移计划,不改文件', false)
|
|
247
|
+
.action((opts) => {
|
|
248
|
+
const paths = getPaths();
|
|
249
|
+
requireInitialized(paths);
|
|
250
|
+
const result = migrateSpecPaths(paths, { dryRun: opts.dryRun });
|
|
251
|
+
if (result.migrated.length === 0) {
|
|
252
|
+
console.log('✓ 无需迁移,active spec 文件名已是 canonical 格式');
|
|
253
|
+
return;
|
|
254
|
+
}
|
|
255
|
+
console.log(`${opts.dryRun ? '计划迁移' : '✓ 已迁移'} ${result.migrated.length} 个 spec 文件:`);
|
|
256
|
+
for (const m of result.migrated) {
|
|
257
|
+
console.log(` ${m.code}`);
|
|
258
|
+
console.log(` from: ${m.from}`);
|
|
259
|
+
console.log(` to: ${m.to}`);
|
|
260
|
+
}
|
|
261
|
+
});
|
|
262
|
+
cmd
|
|
263
|
+
.command('validate-plan <file>')
|
|
264
|
+
.description('校验 planJson 格式(INC-005 字段名 / R11 步数 / R10 末步验证)')
|
|
265
|
+
.action((file) => {
|
|
266
|
+
const plan = JSON.parse(readFileSync(file, 'utf8'));
|
|
267
|
+
const warnings = validatePlanJson(plan);
|
|
268
|
+
if (warnings.length === 0) {
|
|
269
|
+
console.log(`✓ planJson 校验通过`);
|
|
270
|
+
return;
|
|
271
|
+
}
|
|
272
|
+
const paths = getPaths();
|
|
273
|
+
const hitRules = new Set();
|
|
274
|
+
for (const w of warnings) {
|
|
275
|
+
console.log(`⚠ [${w.rule}] ${w.message}`);
|
|
276
|
+
// R10/R11 是规范违反:落 audit 让人 review
|
|
277
|
+
if (w.rule === 'R10' || w.rule === 'R11') {
|
|
278
|
+
hitRules.add(w.rule);
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
for (const ruleId of hitRules) {
|
|
282
|
+
hit({ paths, ruleId });
|
|
283
|
+
}
|
|
284
|
+
});
|
|
285
|
+
}
|
|
286
|
+
function readStdin() {
|
|
287
|
+
return readFileSync(0, 'utf8');
|
|
288
|
+
}
|
|
289
|
+
//# sourceMappingURL=spec.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/cli/spec.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* task 子命令:
|
|
3
|
+
* create <spec> --plan <file> [--auto-confirm]
|
|
4
|
+
* start <task-id>
|
|
5
|
+
* step <task-id> --no <N> --status <s> [--type T] [--name S] [--tool T] [--output-json J] [--input-json J] [--latency L] [--error-code E] [--error-message M]
|
|
6
|
+
* complete <task-id>
|
|
7
|
+
* fail <task-id> [--code E] [--msg M]
|
|
8
|
+
* wait <task-id> [--reason R]
|
|
9
|
+
* show <task-id> [--full]
|
|
10
|
+
* list [--topic T] [--spec S] [--status running]
|
|
11
|
+
*/
|
|
12
|
+
import { Command } from 'commander';
|
|
13
|
+
export declare function registerTaskCommands(program: Command): void;
|
|
14
|
+
//# sourceMappingURL=task.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/cli/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgS3D"}
|