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.
Files changed (159) hide show
  1. package/AGENTS.md +27 -0
  2. package/CODEBUDDY.md +19 -0
  3. package/LICENSE +21 -0
  4. package/README.md +531 -0
  5. package/dist/cli/audit.d.ts +10 -0
  6. package/dist/cli/audit.d.ts.map +1 -0
  7. package/dist/cli/audit.js +62 -0
  8. package/dist/cli/audit.js.map +1 -0
  9. package/dist/cli/change.d.ts +10 -0
  10. package/dist/cli/change.d.ts.map +1 -0
  11. package/dist/cli/change.js +103 -0
  12. package/dist/cli/change.js.map +1 -0
  13. package/dist/cli/common.d.ts +5 -0
  14. package/dist/cli/common.d.ts.map +1 -0
  15. package/dist/cli/common.js +17 -0
  16. package/dist/cli/common.js.map +1 -0
  17. package/dist/cli/decision.d.ts +13 -0
  18. package/dist/cli/decision.d.ts.map +1 -0
  19. package/dist/cli/decision.js +185 -0
  20. package/dist/cli/decision.js.map +1 -0
  21. package/dist/cli/dict.d.ts +10 -0
  22. package/dist/cli/dict.d.ts.map +1 -0
  23. package/dist/cli/dict.js +73 -0
  24. package/dist/cli/dict.js.map +1 -0
  25. package/dist/cli/incident.d.ts +10 -0
  26. package/dist/cli/incident.d.ts.map +1 -0
  27. package/dist/cli/incident.js +119 -0
  28. package/dist/cli/incident.js.map +1 -0
  29. package/dist/cli/index.d.ts +3 -0
  30. package/dist/cli/index.d.ts.map +1 -0
  31. package/dist/cli/index.js +30 -0
  32. package/dist/cli/index.js.map +1 -0
  33. package/dist/cli/project.d.ts +3 -0
  34. package/dist/cli/project.d.ts.map +1 -0
  35. package/dist/cli/project.js +144 -0
  36. package/dist/cli/project.js.map +1 -0
  37. package/dist/cli/spec.d.ts +3 -0
  38. package/dist/cli/spec.d.ts.map +1 -0
  39. package/dist/cli/spec.js +289 -0
  40. package/dist/cli/spec.js.map +1 -0
  41. package/dist/cli/task.d.ts +14 -0
  42. package/dist/cli/task.d.ts.map +1 -0
  43. package/dist/cli/task.js +287 -0
  44. package/dist/cli/task.js.map +1 -0
  45. package/dist/cli/usability.d.ts +3 -0
  46. package/dist/cli/usability.d.ts.map +1 -0
  47. package/dist/cli/usability.js +153 -0
  48. package/dist/cli/usability.js.map +1 -0
  49. package/dist/core/agents.d.ts +43 -0
  50. package/dist/core/agents.d.ts.map +1 -0
  51. package/dist/core/agents.js +194 -0
  52. package/dist/core/agents.js.map +1 -0
  53. package/dist/core/archive.d.ts +35 -0
  54. package/dist/core/archive.d.ts.map +1 -0
  55. package/dist/core/archive.js +360 -0
  56. package/dist/core/archive.js.map +1 -0
  57. package/dist/core/audit-events.d.ts +12 -0
  58. package/dist/core/audit-events.d.ts.map +1 -0
  59. package/dist/core/audit-events.js +16 -0
  60. package/dist/core/audit-events.js.map +1 -0
  61. package/dist/core/audit.d.ts +78 -0
  62. package/dist/core/audit.d.ts.map +1 -0
  63. package/dist/core/audit.js +157 -0
  64. package/dist/core/audit.js.map +1 -0
  65. package/dist/core/constants.d.ts +28 -0
  66. package/dist/core/constants.d.ts.map +1 -0
  67. package/dist/core/constants.js +30 -0
  68. package/dist/core/constants.js.map +1 -0
  69. package/dist/core/decision.d.ts +69 -0
  70. package/dist/core/decision.d.ts.map +1 -0
  71. package/dist/core/decision.js +210 -0
  72. package/dist/core/decision.js.map +1 -0
  73. package/dist/core/delta.d.ts +85 -0
  74. package/dist/core/delta.d.ts.map +1 -0
  75. package/dist/core/delta.js +264 -0
  76. package/dist/core/delta.js.map +1 -0
  77. package/dist/core/dict.d.ts +28 -0
  78. package/dist/core/dict.d.ts.map +1 -0
  79. package/dist/core/dict.js +57 -0
  80. package/dist/core/dict.js.map +1 -0
  81. package/dist/core/frontmatter.d.ts +19 -0
  82. package/dist/core/frontmatter.d.ts.map +1 -0
  83. package/dist/core/frontmatter.js +57 -0
  84. package/dist/core/frontmatter.js.map +1 -0
  85. package/dist/core/incident.d.ts +45 -0
  86. package/dist/core/incident.d.ts.map +1 -0
  87. package/dist/core/incident.js +128 -0
  88. package/dist/core/incident.js.map +1 -0
  89. package/dist/core/paths.d.ts +68 -0
  90. package/dist/core/paths.d.ts.map +1 -0
  91. package/dist/core/paths.js +162 -0
  92. package/dist/core/paths.js.map +1 -0
  93. package/dist/core/repository.d.ts +13 -0
  94. package/dist/core/repository.d.ts.map +1 -0
  95. package/dist/core/repository.js +29 -0
  96. package/dist/core/repository.js.map +1 -0
  97. package/dist/core/spec-io.d.ts +125 -0
  98. package/dist/core/spec-io.d.ts.map +1 -0
  99. package/dist/core/spec-io.js +260 -0
  100. package/dist/core/spec-io.js.map +1 -0
  101. package/dist/core/status.d.ts +22 -0
  102. package/dist/core/status.d.ts.map +1 -0
  103. package/dist/core/status.js +54 -0
  104. package/dist/core/status.js.map +1 -0
  105. package/dist/core/task.d.ts +118 -0
  106. package/dist/core/task.d.ts.map +1 -0
  107. package/dist/core/task.js +340 -0
  108. package/dist/core/task.js.map +1 -0
  109. package/dist/core/usability.d.ts +25 -0
  110. package/dist/core/usability.d.ts.map +1 -0
  111. package/dist/core/usability.js +136 -0
  112. package/dist/core/usability.js.map +1 -0
  113. package/dist/core/validate.d.ts +34 -0
  114. package/dist/core/validate.d.ts.map +1 -0
  115. package/dist/core/validate.js +195 -0
  116. package/dist/core/validate.js.map +1 -0
  117. package/dist/index.d.ts +11 -0
  118. package/dist/index.d.ts.map +1 -0
  119. package/dist/index.js +12 -0
  120. package/dist/index.js.map +1 -0
  121. package/dist/schemas/change.d.ts +138 -0
  122. package/dist/schemas/change.d.ts.map +1 -0
  123. package/dist/schemas/change.js +38 -0
  124. package/dist/schemas/change.js.map +1 -0
  125. package/dist/schemas/spec.d.ts +233 -0
  126. package/dist/schemas/spec.d.ts.map +1 -0
  127. package/dist/schemas/spec.js +56 -0
  128. package/dist/schemas/spec.js.map +1 -0
  129. package/package.json +66 -0
  130. package/rules/_TEMPLATE.md +20 -0
  131. package/rules/code-discipline.md +47 -0
  132. package/rules/codebase-survey.md +37 -0
  133. package/rules/delta.md +42 -0
  134. package/rules/doc-governance.md +195 -0
  135. package/rules/flow-control.md +65 -0
  136. package/rules/quality-gate.md +73 -0
  137. package/skill/SKILL.md +90 -0
  138. package/skill/subskills/adr.md +73 -0
  139. package/skill/subskills/change.md +118 -0
  140. package/skill/subskills/design.md +53 -0
  141. package/skill/subskills/impl.md +100 -0
  142. package/skill/subskills/plan.md +46 -0
  143. package/skill/subskills/postmortem.md +77 -0
  144. package/skill/subskills/prd.md +72 -0
  145. package/skill/subskills/quick.md +25 -0
  146. package/skill/subskills/release.md +50 -0
  147. package/skill/subskills/research.md +35 -0
  148. package/skill/subskills/runbook.md +44 -0
  149. package/skill/subskills/testplan.md +48 -0
  150. package/templates/L0-prd.md +43 -0
  151. package/templates/L1-prd.md +130 -0
  152. package/templates/L2-design.md +135 -0
  153. package/templates/L3-impl.md +125 -0
  154. package/templates/agent-plan.json +17 -0
  155. package/templates/agents/AGENTS.md +27 -0
  156. package/templates/agents/CLAUDE.md +11 -0
  157. package/templates/agents/CODEBUDDY.md +23 -0
  158. package/templates/agents/codebuddy-skill/SKILL.md +46 -0
  159. package/templates/decision.md +42 -0
@@ -0,0 +1,194 @@
1
+ import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
2
+ import { dirname, join, relative } from 'node:path';
3
+ export const AGENT_PROVIDERS = ['claude', 'codex', 'opencode', 'codebuddy'];
4
+ export const AGENT_PROVIDER_INFO = [
5
+ {
6
+ provider: 'claude',
7
+ aliases: ['claude', 'claude-code'],
8
+ files: ['CLAUDE.md', '.claude/skills/spec-manager/'],
9
+ description: 'Claude Code project instructions and spec-manager skill.',
10
+ notes: ['Claude Code can invoke the spec-manager skill with /spec-manager.'],
11
+ installSteps: [
12
+ { kind: 'template', source: 'templates/agents/CLAUDE.md', target: 'CLAUDE.md' },
13
+ { kind: 'directory', source: 'skill', target: '.claude/skills/spec-manager' },
14
+ { kind: 'directory', source: 'rules', target: '.claude/skills/spec-manager/rules' },
15
+ { kind: 'directory', source: 'templates', target: '.claude/skills/spec-manager/templates' },
16
+ ],
17
+ },
18
+ {
19
+ provider: 'codex',
20
+ aliases: ['codex', 'openai-codex'],
21
+ files: ['AGENTS.md'],
22
+ description: 'Codex project instructions via AGENTS.md.',
23
+ notes: ['Codex reads project instructions from AGENTS.md.'],
24
+ installSteps: [
25
+ { kind: 'template', source: 'templates/agents/AGENTS.md', target: 'AGENTS.md' },
26
+ ],
27
+ },
28
+ {
29
+ provider: 'opencode',
30
+ aliases: ['opencode', 'open-code', 'open code'],
31
+ files: ['AGENTS.md'],
32
+ description: 'OpenCode project instructions via AGENTS.md.',
33
+ notes: ['OpenCode reads AGENTS.md and also falls back to CLAUDE.md when AGENTS.md is absent.'],
34
+ installSteps: [
35
+ { kind: 'template', source: 'templates/agents/AGENTS.md', target: 'AGENTS.md' },
36
+ ],
37
+ },
38
+ {
39
+ provider: 'codebuddy',
40
+ aliases: ['codebuddy', 'code-buddy', 'code buddy', 'cbc'],
41
+ files: ['CODEBUDDY.md', '.codebuddy/skills/spec-manager/'],
42
+ description: 'CodeBuddy project instructions and spec-manager skill.',
43
+ notes: ['CodeBuddy reads CODEBUDDY.md and auto-discovers .codebuddy/skills/spec-manager.'],
44
+ installSteps: [
45
+ { kind: 'template', source: 'templates/agents/CODEBUDDY.md', target: 'CODEBUDDY.md' },
46
+ {
47
+ kind: 'template',
48
+ source: 'templates/agents/codebuddy-skill/SKILL.md',
49
+ target: '.codebuddy/skills/spec-manager/SKILL.md',
50
+ },
51
+ { kind: 'directory', source: 'skill/subskills', target: '.codebuddy/skills/spec-manager/subskills' },
52
+ { kind: 'directory', source: 'rules', target: '.codebuddy/skills/spec-manager/rules' },
53
+ { kind: 'directory', source: 'templates', target: '.codebuddy/skills/spec-manager/templates' },
54
+ ],
55
+ },
56
+ ];
57
+ export function parseAgentProviders(input) {
58
+ const parts = input
59
+ .split(',')
60
+ .map((p) => p.trim())
61
+ .filter((p) => p.length > 0);
62
+ if (parts.length === 0)
63
+ return ['all'];
64
+ const providers = parts.map(normalizeAgentProvider);
65
+ return providers.includes('all') ? ['all'] : providers;
66
+ }
67
+ export function normalizeAgentProvider(input) {
68
+ const key = input.toLowerCase().trim().replace(/[\s_-]+/g, '-');
69
+ if (key === 'all' || key === '*')
70
+ return 'all';
71
+ const provider = AGENT_PROVIDER_INFO.find((info) => info.aliases.map((alias) => alias.toLowerCase().replace(/[\s_-]+/g, '-')).includes(key));
72
+ if (provider)
73
+ return provider.provider;
74
+ throw new Error(`unsupported AI provider: ${input}. Use one of: all, ${AGENT_PROVIDERS.join(', ')}`);
75
+ }
76
+ export function expandAgentProviders(providers) {
77
+ if (providers.includes('all'))
78
+ return [...AGENT_PROVIDERS];
79
+ const out = [];
80
+ for (const provider of providers) {
81
+ if (provider === 'all')
82
+ continue;
83
+ if (!out.includes(provider))
84
+ out.push(provider);
85
+ }
86
+ return out;
87
+ }
88
+ export function listAgentProviders() {
89
+ return AGENT_PROVIDER_INFO;
90
+ }
91
+ export function installAgentSupport(options) {
92
+ const providers = expandAgentProviders(options.providers);
93
+ const report = {
94
+ providers,
95
+ dryRun: Boolean(options.dryRun),
96
+ created: [],
97
+ overwritten: [],
98
+ skipped: [],
99
+ notes: [],
100
+ };
101
+ const installedTargets = new Set();
102
+ for (const provider of providers) {
103
+ const config = providerConfig(provider);
104
+ for (const step of config.installSteps) {
105
+ if (installedTargets.has(step.target))
106
+ continue;
107
+ installedTargets.add(step.target);
108
+ applyInstallStep(options, report, step);
109
+ }
110
+ report.notes.push(...config.notes);
111
+ }
112
+ return report;
113
+ }
114
+ function providerConfig(provider) {
115
+ const config = AGENT_PROVIDER_INFO.find((p) => p.provider === provider);
116
+ if (!config)
117
+ throw new Error(`unsupported AI provider: ${provider}`);
118
+ return config;
119
+ }
120
+ function applyInstallStep(options, report, step) {
121
+ if (step.kind === 'template') {
122
+ writeTemplate(options, report, step.source, step.target);
123
+ }
124
+ else {
125
+ copyDirectory(options, report, join(options.packageRoot, ...step.source.split('/')), join(options.paths.root, ...step.target.split('/')));
126
+ }
127
+ }
128
+ function writeTemplate(options, report, templateRelPath, targetRelPath) {
129
+ const source = join(options.packageRoot, ...templateRelPath.split('/'));
130
+ const target = join(options.paths.root, ...targetRelPath.split('/'));
131
+ const content = readFileSync(source, 'utf8');
132
+ writeManagedFile(options, report, target, content);
133
+ }
134
+ function writeManagedFile(options, report, target, content) {
135
+ const path = displayPath(options.paths, target);
136
+ const existed = existsSync(target);
137
+ if (existed && !options.force) {
138
+ report.skipped.push(path);
139
+ return;
140
+ }
141
+ if (options.dryRun) {
142
+ if (existed) {
143
+ report.overwritten.push(path);
144
+ }
145
+ else {
146
+ report.created.push(path);
147
+ }
148
+ return;
149
+ }
150
+ mkdirSync(dirname(target), { recursive: true });
151
+ writeFileSync(target, content, 'utf8');
152
+ if (existed && options.force) {
153
+ report.overwritten.push(path);
154
+ }
155
+ else {
156
+ report.created.push(path);
157
+ }
158
+ }
159
+ function copyDirectory(options, report, source, target) {
160
+ const path = displayPath(options.paths, target);
161
+ if (!existsSync(source)) {
162
+ report.notes.push(`missing bundled asset: ${source}`);
163
+ return;
164
+ }
165
+ if (existsSync(target) && !options.force) {
166
+ report.skipped.push(path);
167
+ return;
168
+ }
169
+ if (options.dryRun) {
170
+ if (existsSync(target)) {
171
+ report.overwritten.push(path);
172
+ }
173
+ else {
174
+ report.created.push(path);
175
+ }
176
+ return;
177
+ }
178
+ mkdirSync(dirname(target), { recursive: true });
179
+ const existed = existsSync(target);
180
+ if (existed && options.force)
181
+ rmSync(target, { recursive: true, force: true });
182
+ cpSync(source, target, { recursive: true });
183
+ if (existed && options.force) {
184
+ report.overwritten.push(path);
185
+ }
186
+ else {
187
+ report.created.push(path);
188
+ }
189
+ }
190
+ function displayPath(paths, target) {
191
+ const rel = relative(paths.root, target);
192
+ return rel.length > 0 ? rel : target;
193
+ }
194
+ //# sourceMappingURL=agents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/core/agents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Delta Archive — 把 changes/<name>/ 应用到主 specs/ 目录
3
+ *
4
+ * 应用顺序:RENAMED → REMOVED → MODIFIED → ADDED
5
+ * RENAMED: spec 文件改名 + frontmatter code 字段改写
6
+ * REMOVED: spec 文件移到 archive/(保留)
7
+ * MODIFIED: 把 delta 内容追加到主 spec(或用 delta 替换某个 ## 段)
8
+ * ADDED: 创建新 spec
9
+ *
10
+ * 应用后:
11
+ * - 把整个 changes/<name>/ 目录移到 archive/<name>/
12
+ * - 写入 audit:R24 命中
13
+ */
14
+ import { type AuditSink } from './audit-events.js';
15
+ import { type ProjectPaths } from './paths.js';
16
+ import { type ChangeOpT } from '../schemas/change.js';
17
+ export interface ArchiveResult {
18
+ changeName: string;
19
+ applied: Array<{
20
+ op: ChangeOpT;
21
+ code: string;
22
+ from?: string;
23
+ to?: string;
24
+ }>;
25
+ skipped: Array<{
26
+ op: ChangeOpT;
27
+ code: string;
28
+ reason: string;
29
+ }>;
30
+ archivedTo: string;
31
+ }
32
+ export declare function archiveChange(paths: ProjectPaths, name: string, opts?: {
33
+ auditSink?: AuditSink;
34
+ }): ArchiveResult;
35
+ //# sourceMappingURL=archive.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,aAAa,CAgKhH"}
@@ -0,0 +1,360 @@
1
+ /**
2
+ * Delta Archive — 把 changes/<name>/ 应用到主 specs/ 目录
3
+ *
4
+ * 应用顺序:RENAMED → REMOVED → MODIFIED → ADDED
5
+ * RENAMED: spec 文件改名 + frontmatter code 字段改写
6
+ * REMOVED: spec 文件移到 archive/(保留)
7
+ * MODIFIED: 把 delta 内容追加到主 spec(或用 delta 替换某个 ## 段)
8
+ * ADDED: 创建新 spec
9
+ *
10
+ * 应用后:
11
+ * - 把整个 changes/<name>/ 目录移到 archive/<name>/
12
+ * - 写入 audit:R24 命中
13
+ */
14
+ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, unlinkSync } from 'node:fs';
15
+ import { dirname, join, basename } from 'node:path';
16
+ import { readFrontmatter, writeFrontmatter, writeAtomic } from './frontmatter.js';
17
+ import { parseDeltaSpec, getChangeDir } from './delta.js';
18
+ import { findSpecByCode, readSpec, writeSpec, createSpec, invalidateSpecCache, listAllSpecs } from './spec-io.js';
19
+ import { recordAuditHit } from './audit-events.js';
20
+ import { assertSafeSpecCode, assertSafeTopic } from './paths.js';
21
+ import { ProposalSchema } from '../schemas/change.js';
22
+ export function archiveChange(paths, name, opts) {
23
+ validateChangeProposal(paths, name, opts?.auditSink);
24
+ // 1. 解析 delta
25
+ const delta = parseDeltaSpec(paths, name);
26
+ // 2. 按顺序应用
27
+ const order = ['RENAMED', 'REMOVED', 'MODIFIED', 'ADDED'];
28
+ const applied = [];
29
+ const skipped = [];
30
+ const sortedEntries = [...delta.changes].sort((a, b) => {
31
+ return order.indexOf(a.op) - order.indexOf(b.op);
32
+ });
33
+ preflightArchive(paths, name, sortedEntries);
34
+ const tx = new ArchiveApplyTransaction();
35
+ for (const e of sortedEntries) {
36
+ try {
37
+ switch (e.op) {
38
+ case 'RENAMED': {
39
+ if (!e.newCode)
40
+ throw new Error('RENAMED 缺 newCode');
41
+ const spec = findSpecByCode(paths, e.code);
42
+ if (!spec)
43
+ throw new Error(`Spec not found: ${e.code}`);
44
+ const newFilePath = renamedFilePath(spec, e.newCode);
45
+ tx.snapshot(spec.filePath);
46
+ if (spec.filePath !== newFilePath)
47
+ tx.trackCreated(newFilePath);
48
+ const newSpec = {
49
+ ...spec,
50
+ filePath: newFilePath,
51
+ fm: { ...spec.fm, code: e.newCode, updated: new Date().toISOString(), changeSummary: `delta RENAMED: ${e.code} → ${e.newCode}` },
52
+ };
53
+ writeSpec(newSpec);
54
+ // 平铺布局下旧文件已被 writeSpec 覆盖(同 topic 目录),需显式删除旧文件
55
+ if (spec.filePath !== newFilePath && existsSync(spec.filePath)) {
56
+ rmSync(spec.filePath, { force: true });
57
+ }
58
+ applied.push({ op: e.op, code: e.code, from: e.code, to: e.newCode });
59
+ break;
60
+ }
61
+ case 'REMOVED': {
62
+ const spec = findSpecByCode(paths, e.code);
63
+ if (!spec)
64
+ throw new Error(`Spec not found: ${e.code}`);
65
+ tx.snapshot(spec.filePath);
66
+ // 移到 archive/<name>/<relative-path>
67
+ const archivePath = join(paths.archiveDir, name);
68
+ mkdirSync(archivePath, { recursive: true });
69
+ const relativePath = spec.filePath.replace(paths.root + '/', '');
70
+ const targetPath = join(archivePath, relativePath);
71
+ tx.trackCreated(targetPath);
72
+ writeAtomic(targetPath, writeFrontmatter({ ...spec.fm, status: 'archived' }, spec.content));
73
+ // 删主 spec
74
+ unlinkSync(spec.filePath);
75
+ invalidateSpecCache(spec.filePath);
76
+ applied.push({ op: e.op, code: e.code });
77
+ break;
78
+ }
79
+ case 'MODIFIED': {
80
+ const spec = findSpecByCode(paths, e.code);
81
+ if (!spec)
82
+ throw new Error(`Spec not found: ${e.code}`);
83
+ if (!e.content)
84
+ throw new Error('MODIFIED 缺 content');
85
+ tx.snapshot(spec.filePath);
86
+ // 简单策略:追加 delta 内容到主 spec 的正文末尾(带 ## Delta 段标识)
87
+ const marker = `## Delta (${name})`;
88
+ let newContent = spec.content;
89
+ // 移除旧的 delta 段(如果存在)
90
+ const re = new RegExp(`\n*${marker}[\\s\\S]*?(?=\n## |$)`, 'm');
91
+ newContent = newContent.replace(re, '');
92
+ newContent = newContent.trimEnd() + `\n\n${marker}\n\n${e.content.trim()}\n`;
93
+ const updated = {
94
+ ...spec,
95
+ content: newContent,
96
+ fm: { ...spec.fm, updated: new Date().toISOString(), changeSummary: e.changeSummary ?? `delta MODIFIED` },
97
+ };
98
+ writeSpec(updated);
99
+ applied.push({ op: e.op, code: e.code });
100
+ break;
101
+ }
102
+ case 'ADDED': {
103
+ if (findSpecByCode(paths, e.code)) {
104
+ throw new Error(`Spec ${e.code} 已存在,无法 ADDED`);
105
+ }
106
+ const dir = getChangeDir(paths, name);
107
+ let topic = '';
108
+ let placeholder = null;
109
+ if (dir) {
110
+ for (const f of dir.specFiles) {
111
+ if (f.endsWith(`/${e.code}.md`)) {
112
+ topic = basename(dirname(dirname(f)));
113
+ const rec = readSpec(f);
114
+ if (rec)
115
+ placeholder = rec;
116
+ break;
117
+ }
118
+ }
119
+ }
120
+ if (!topic) {
121
+ throw new Error(`无法推断 ${e.code} 的 topic(请把占位文件放在 changes/${name}/specs/<topic>/${e.code}/${e.code}.md)`);
122
+ }
123
+ const finalLevel = (placeholder?.fm.level ?? e.level);
124
+ const finalTitle = placeholder?.fm.title ?? e.title;
125
+ const finalParent = placeholder?.fm.parentCode ?? e.parentCode ?? null;
126
+ if (!finalLevel)
127
+ throw new Error(`ADDED 缺 level(占位文件 frontmatter 也未指定)`);
128
+ if (!finalTitle)
129
+ throw new Error(`ADDED 缺 title(占位文件 frontmatter 也未指定)`);
130
+ let parentRecord = null;
131
+ if (finalParent) {
132
+ parentRecord = findSpecByCode(paths, finalParent);
133
+ if (!parentRecord)
134
+ throw new Error(`parentCode 指向不存在的 spec: ${finalParent}`);
135
+ }
136
+ const newSpec = createSpec({
137
+ paths,
138
+ code: e.code,
139
+ level: finalLevel,
140
+ title: finalTitle,
141
+ topic,
142
+ parentCode: finalParent,
143
+ parentRecord,
144
+ auditSink: opts?.auditSink,
145
+ });
146
+ tx.trackCreated(newSpec.filePath);
147
+ if (e.content) {
148
+ const updated = {
149
+ ...newSpec,
150
+ content: e.content,
151
+ fm: { ...newSpec.fm, aiSummary: e.content.slice(0, 200), changeSummary: e.changeSummary ?? `delta ADDED` },
152
+ };
153
+ writeSpec(updated);
154
+ }
155
+ applied.push({ op: e.op, code: e.code });
156
+ break;
157
+ }
158
+ }
159
+ }
160
+ catch (err) {
161
+ const reason = err instanceof Error ? err.message : String(err);
162
+ skipped.push({ op: e.op, code: e.code, reason });
163
+ break;
164
+ }
165
+ }
166
+ if (skipped.length > 0) {
167
+ tx.rollback();
168
+ throw new Error(renderArchiveError(name, skipped, 'Change 应用失败,已停止归档'));
169
+ }
170
+ // 3. 把 changes/<name>/ 整体移到 archive/<name>/
171
+ const changeRoot = join(paths.changesDir, name);
172
+ const archiveTarget = join(paths.archiveDir, name);
173
+ if (existsSync(archiveTarget)) {
174
+ // 已存在:加时间戳
175
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
176
+ const finalTarget = join(paths.archiveDir, `${name}-${stamp}`);
177
+ mkdirSync(dirname(finalTarget), { recursive: true });
178
+ renameSync(changeRoot, finalTarget);
179
+ recordAuditHit({ paths, ruleId: 'R24' }, opts?.auditSink);
180
+ return { changeName: name, applied, skipped, archivedTo: finalTarget };
181
+ }
182
+ else {
183
+ mkdirSync(paths.archiveDir, { recursive: true });
184
+ renameSync(changeRoot, archiveTarget);
185
+ recordAuditHit({ paths, ruleId: 'R24' }, opts?.auditSink);
186
+ return { changeName: name, applied, skipped, archivedTo: archiveTarget };
187
+ }
188
+ }
189
+ class ArchiveApplyTransaction {
190
+ snapshots = new Map();
191
+ created = new Set();
192
+ snapshot(filePath) {
193
+ if (!this.snapshots.has(filePath) && existsSync(filePath)) {
194
+ this.snapshots.set(filePath, readFileSync(filePath, 'utf8'));
195
+ }
196
+ }
197
+ trackCreated(filePath) {
198
+ if (!this.snapshots.has(filePath)) {
199
+ this.created.add(filePath);
200
+ }
201
+ }
202
+ rollback() {
203
+ for (const filePath of [...this.created].reverse()) {
204
+ if (existsSync(filePath))
205
+ rmSync(filePath, { force: true });
206
+ }
207
+ for (const [filePath, content] of [...this.snapshots].reverse()) {
208
+ writeAtomic(filePath, content);
209
+ }
210
+ invalidateSpecCache();
211
+ }
212
+ }
213
+ function validateChangeProposal(paths, name, auditSink) {
214
+ const dir = getChangeDir(paths, name);
215
+ if (!dir)
216
+ throw new Error(`Change not found: ${name}`);
217
+ if (!existsSync(dir.proposal)) {
218
+ recordAuditHit({ paths, ruleId: 'R24' }, auditSink);
219
+ throw new Error(`R24: delta change 必须包含 proposal.md`);
220
+ }
221
+ try {
222
+ const { data } = readFrontmatter(dir.proposal);
223
+ ProposalSchema.parse(data);
224
+ }
225
+ catch (err) {
226
+ recordAuditHit({ paths, ruleId: 'R24' }, auditSink);
227
+ const reason = err instanceof Error ? err.message : String(err);
228
+ throw new Error(`R24: proposal.md 必须填写 why/scope 并通过 schema 校验: ${reason}`);
229
+ }
230
+ }
231
+ function preflightArchive(paths, name, entries) {
232
+ const specsByCode = new Map(listAllSpecs(paths).map(s => [s.fm.code, s]));
233
+ const errors = [];
234
+ for (const e of entries) {
235
+ try {
236
+ switch (e.op) {
237
+ case 'RENAMED': {
238
+ if (!e.newCode)
239
+ throw new Error('RENAMED 缺 newCode');
240
+ assertSafeSpecCode(e.newCode);
241
+ const spec = specsByCode.get(e.code);
242
+ if (!spec)
243
+ throw new Error(`Spec not found: ${e.code}`);
244
+ if (e.newCode === e.code)
245
+ throw new Error('RENAMED 的 newCode 不能等于原 code');
246
+ if (specsByCode.has(e.newCode))
247
+ throw new Error(`目标 spec 已存在: ${e.newCode}`);
248
+ const newFilePath = renamedFilePath(spec, e.newCode);
249
+ if (existsSync(newFilePath) && newFilePath !== spec.filePath) {
250
+ throw new Error(`目标文件已存在: ${newFilePath}`);
251
+ }
252
+ specsByCode.delete(e.code);
253
+ specsByCode.set(e.newCode, { ...spec, fm: { ...spec.fm, code: e.newCode }, filePath: newFilePath });
254
+ break;
255
+ }
256
+ case 'REMOVED': {
257
+ if (!specsByCode.has(e.code))
258
+ throw new Error(`Spec not found: ${e.code}`);
259
+ specsByCode.delete(e.code);
260
+ break;
261
+ }
262
+ case 'MODIFIED': {
263
+ if (!specsByCode.has(e.code))
264
+ throw new Error(`Spec not found: ${e.code}`);
265
+ if (!e.content)
266
+ throw new Error('MODIFIED 缺 content');
267
+ break;
268
+ }
269
+ case 'ADDED': {
270
+ assertSafeSpecCode(e.code);
271
+ if (specsByCode.has(e.code))
272
+ throw new Error(`Spec ${e.code} 已存在,无法 ADDED`);
273
+ const meta = resolveAddedMetadata(paths, name, e);
274
+ assertSafeTopic(meta.topic);
275
+ validateParentForAdded(specsByCode, e.code, meta.level, meta.parentCode);
276
+ specsByCode.set(e.code, {
277
+ fm: {
278
+ code: e.code,
279
+ level: meta.level,
280
+ title: meta.title,
281
+ topic: meta.topic,
282
+ parentCode: meta.parentCode,
283
+ status: 'draft',
284
+ },
285
+ content: '',
286
+ filePath: '',
287
+ });
288
+ break;
289
+ }
290
+ }
291
+ }
292
+ catch (err) {
293
+ const reason = err instanceof Error ? err.message : String(err);
294
+ errors.push({ op: e.op, code: e.code, reason });
295
+ }
296
+ }
297
+ if (errors.length > 0) {
298
+ throw new Error(renderArchiveError(name, errors, 'Change 预检失败,未修改 specs 且未归档'));
299
+ }
300
+ }
301
+ function renamedFilePath(spec, newCode) {
302
+ const specDir = dirname(spec.filePath);
303
+ return join(specDir, `${newCode}.md`);
304
+ }
305
+ function resolveAddedMetadata(paths, name, entry) {
306
+ const dir = getChangeDir(paths, name);
307
+ let topic = '';
308
+ let placeholder = null;
309
+ if (dir) {
310
+ for (const f of dir.specFiles) {
311
+ if (f.endsWith(`/${entry.code}.md`)) {
312
+ topic = basename(dirname(dirname(f)));
313
+ const rec = readSpec(f);
314
+ if (rec)
315
+ placeholder = rec;
316
+ break;
317
+ }
318
+ }
319
+ }
320
+ if (!topic) {
321
+ throw new Error(`无法推断 ${entry.code} 的 topic(请把占位文件放在 changes/${name}/specs/<topic>/${entry.code}/${entry.code}.md)`);
322
+ }
323
+ const level = (placeholder?.fm.level ?? entry.level);
324
+ const title = placeholder?.fm.title ?? entry.title;
325
+ const parentCode = placeholder?.fm.parentCode ?? entry.parentCode ?? null;
326
+ if (!level)
327
+ throw new Error('ADDED 缺 level(占位文件 frontmatter 也未指定)');
328
+ if (!title)
329
+ throw new Error('ADDED 缺 title(占位文件 frontmatter 也未指定)');
330
+ return { topic, level, title, parentCode };
331
+ }
332
+ function validateParentForAdded(specsByCode, code, level, parentCode) {
333
+ const expectedParentLevels = {
334
+ L0: [],
335
+ L1: [],
336
+ L2: ['L0', 'L1'],
337
+ L3: ['L2'],
338
+ };
339
+ if (!parentCode) {
340
+ if (level === 'L2' || level === 'L3')
341
+ throw new Error(`R7: ${level} 必须有 parentCode`);
342
+ return;
343
+ }
344
+ const parent = specsByCode.get(parentCode);
345
+ if (!parent)
346
+ throw new Error(`parentCode 指向不存在的 spec: ${parentCode}`);
347
+ if (!expectedParentLevels[level].includes(parent.fm.level)) {
348
+ throw new Error(`R7: ${level} 的 parent 必须是 ${expectedParentLevels[level].join('/')}, ` +
349
+ `实际是 ${parent.fm.level} (${parentCode})`);
350
+ }
351
+ if (code === parentCode)
352
+ throw new Error('ADDED 的 parentCode 不能等于自身 code');
353
+ }
354
+ function renderArchiveError(name, skipped, header) {
355
+ const lines = [`${header}: ${name}`];
356
+ for (const s of skipped)
357
+ lines.push(`[${s.op}] ${s.code}: ${s.reason}`);
358
+ return lines.join('\n');
359
+ }
360
+ //# sourceMappingURL=archive.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import { type HitInput } from './audit.js';
2
+ export type AuditEvent = HitInput;
3
+ export interface AuditSink {
4
+ hit(event: AuditEvent): void;
5
+ }
6
+ export declare const writeAuditSink: AuditSink;
7
+ export declare class CollectingAuditSink implements AuditSink {
8
+ readonly events: AuditEvent[];
9
+ hit(event: AuditEvent): void;
10
+ }
11
+ export declare function recordAuditHit(event: AuditEvent, sink?: AuditSink): void;
12
+ //# sourceMappingURL=audit-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit-events.d.ts","sourceRoot":"","sources":["../../src/core/audit-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;AAElC,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,SAI5B,CAAC;AAEF,qBAAa,mBAAoB,YAAW,SAAS;IACnD,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;IAEnC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAG7B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,SAA0B,GAAG,IAAI,CAExF"}