ccjk 12.0.7 → 12.0.9

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 (47) hide show
  1. package/dist/chunks/agents.mjs +1 -1
  2. package/dist/chunks/auto-fixer.mjs +93 -0
  3. package/dist/chunks/auto-updater.mjs +3 -2
  4. package/dist/chunks/boost.mjs +1 -1
  5. package/dist/chunks/ccr.mjs +4 -3
  6. package/dist/chunks/check-updates.mjs +3 -2
  7. package/dist/chunks/claude-code-incremental-manager.mjs +3 -2
  8. package/dist/chunks/codex-config-switch.mjs +2 -1
  9. package/dist/chunks/codex-provider-manager.mjs +2 -1
  10. package/dist/chunks/codex-uninstaller.mjs +1 -1
  11. package/dist/chunks/codex.mjs +1 -1
  12. package/dist/chunks/config-switch.mjs +2 -1
  13. package/dist/chunks/config2.mjs +2 -1
  14. package/dist/chunks/doctor.mjs +1 -0
  15. package/dist/chunks/features.mjs +3 -2
  16. package/dist/chunks/index10.mjs +569 -1061
  17. package/dist/chunks/index11.mjs +1076 -913
  18. package/dist/chunks/index12.mjs +951 -135
  19. package/dist/chunks/index13.mjs +184 -209
  20. package/dist/chunks/index14.mjs +210 -655
  21. package/dist/chunks/index4.mjs +1 -1
  22. package/dist/chunks/index7.mjs +201 -2182
  23. package/dist/chunks/init.mjs +5 -5
  24. package/dist/chunks/installer.mjs +2 -1
  25. package/dist/chunks/mcp-cli.mjs +2 -1
  26. package/dist/chunks/mcp.mjs +2 -1
  27. package/dist/chunks/menu.mjs +22 -11
  28. package/dist/chunks/onboarding-wizard.mjs +93 -0
  29. package/dist/chunks/onboarding.mjs +1 -0
  30. package/dist/chunks/package.mjs +1 -1
  31. package/dist/chunks/prompts.mjs +2 -1
  32. package/dist/chunks/quick-actions.mjs +1 -1
  33. package/dist/chunks/quick-provider.mjs +1 -0
  34. package/dist/chunks/quick-setup.mjs +3 -2
  35. package/dist/chunks/remote.mjs +1 -0
  36. package/dist/chunks/status.mjs +7 -2
  37. package/dist/chunks/uninstall.mjs +3 -2
  38. package/dist/chunks/update.mjs +3 -2
  39. package/dist/chunks/upgrade-manager.mjs +1 -1
  40. package/dist/chunks/wsl.mjs +1 -1
  41. package/dist/cli.mjs +19 -3
  42. package/dist/shared/{ccjk.DOwtZMk8.mjs → ccjk.BWFpnOr3.mjs} +7 -1831
  43. package/dist/shared/{ccjk.D5MFQT7w.mjs → ccjk.CNMWk_mE.mjs} +7 -7
  44. package/dist/shared/{ccjk.BRZ9ww8S.mjs → ccjk.CvChMYvB.mjs} +1 -1
  45. package/dist/shared/ccjk.DeWpAShp.mjs +1828 -0
  46. package/dist/shared/{ccjk.BwfbSKN2.mjs → ccjk.Dx-O9dWz.mjs} +1 -1
  47. package/package.json +2 -2
@@ -1,1008 +1,1171 @@
1
- import a from './index2.mjs';
2
- import ora from './index7.mjs';
3
- import fs from 'node:fs/promises';
4
- import os__default from 'node:os';
5
- import path__default from 'node:path';
6
- import { exec } from 'node:child_process';
7
- import { promisify } from 'node:util';
8
- import '../shared/ccjk.BAGoDD49.mjs';
9
- import 'node:process';
10
- import '../shared/ccjk.Cjgrln_h.mjs';
1
+ import { execSync } from 'node:child_process';
2
+ import * as path from 'node:path';
3
+ import * as process from 'node:process';
4
+ import * as fs from 'node:fs';
11
5
 
12
- function getCcjkConfigDir() {
13
- if (process.env.CCJK_CONFIG_DIR) {
14
- return process.env.CCJK_CONFIG_DIR;
6
+ function getFixCommits(options) {
7
+ const { since, until, limit = 100, cwd = process.cwd() } = options;
8
+ let gitCmd = 'git log --pretty=format:"%H|%h|%s|%an|%ai" --name-only';
9
+ if (since) {
10
+ gitCmd += ` ${since}..${until || "HEAD"}`;
11
+ }
12
+ gitCmd += ` -n ${limit}`;
13
+ try {
14
+ const output = execSync(gitCmd, { cwd, encoding: "utf-8" });
15
+ return parseGitLog(output);
16
+ } catch {
17
+ return [];
15
18
  }
16
- return path__default.join(os__default.homedir(), ".ccjk");
17
- }
18
- function getInstallPath(pluginType, name) {
19
- const configDir = getCcjkConfigDir();
20
- const typeDir = {
21
- skill: "skills",
22
- mcp: "mcp-servers",
23
- agent: "agents",
24
- hook: "hooks"
25
- }[pluginType];
26
- return path__default.join(configDir, typeDir, name);
27
19
  }
28
- async function copyDirectory(src, dest) {
29
- await fs.mkdir(dest, { recursive: true });
30
- const entries = await fs.readdir(src, { withFileTypes: true });
20
+ function parseGitLog(output) {
21
+ const commits = [];
22
+ const entries = output.trim().split("\n\n");
31
23
  for (const entry of entries) {
32
- const srcPath = path__default.join(src, entry.name);
33
- const destPath = path__default.join(dest, entry.name);
34
- if (entry.isDirectory()) {
35
- await copyDirectory(srcPath, destPath);
36
- } else {
37
- await fs.copyFile(srcPath, destPath);
24
+ const lines = entry.split("\n");
25
+ if (lines.length === 0)
26
+ continue;
27
+ const [firstLine, ...fileLines] = lines;
28
+ const parts = firstLine.split("|");
29
+ if (parts.length < 5)
30
+ continue;
31
+ const [hash, shortHash, message, author, date] = parts;
32
+ const files = fileLines.filter((f) => f.trim());
33
+ if (isFixCommit(message)) {
34
+ commits.push({
35
+ hash,
36
+ shortHash,
37
+ message,
38
+ author,
39
+ date,
40
+ files
41
+ });
38
42
  }
39
43
  }
44
+ return commits;
40
45
  }
41
- async function downloadFile(url, destPath) {
42
- const response = await fetch(url, {
43
- headers: {
44
- "User-Agent": "ccjk-cli"
45
- },
46
- redirect: "follow"
47
- });
48
- if (!response.ok) {
49
- throw new Error(`Failed to download: ${response.statusText}`);
50
- }
51
- const buffer = Buffer.from(await response.arrayBuffer());
52
- await fs.writeFile(destPath, buffer);
46
+ function isFixCommit(message) {
47
+ const fixPatterns = [
48
+ /^fix[(:]/i,
49
+ /^bugfix[(:]/i,
50
+ /^hotfix[(:]/i,
51
+ /\bfix\b/i,
52
+ /\bbug\b/i,
53
+ /\brepair\b/i,
54
+ /\bresolve\b/i,
55
+ /\bcorrect\b/i,
56
+ /修复/,
57
+ /修正/,
58
+ /解决/,
59
+ /bug/i
60
+ ];
61
+ return fixPatterns.some((p) => p.test(message));
53
62
  }
54
-
55
- async function installFromGitHub(sourceInfo, pluginType, options = {}) {
56
- const { force = false, dryRun = false } = options;
57
- const { owner, repo, ref = "main", subpath } = sourceInfo;
63
+ function analyzeFixCommit(commit, cwd = process.cwd()) {
64
+ const diff = getCommitDiff(commit.hash, cwd);
65
+ const bugType = detectBugType(commit.message, diff);
66
+ const severity = detectSeverity(commit.message, diff, commit.files);
67
+ const rootCause = extractRootCause(commit.message, diff);
68
+ const solution = extractSolution(diff);
69
+ const preventionSuggestions = generatePreventionSuggestions(bugType);
70
+ return {
71
+ commit,
72
+ bugType,
73
+ severity,
74
+ rootCause,
75
+ solution,
76
+ preventionSuggestions,
77
+ relatedPostmortems: []
78
+ };
79
+ }
80
+ function getCommitDiff(hash, cwd) {
58
81
  try {
59
- const repoInfo = await fetchRepoInfo(owner, repo);
60
- const defaultBranch = repoInfo.default_branch || "main";
61
- const actualRef = ref || defaultBranch;
62
- const installPath = getInstallPath(pluginType, repo);
63
- if (!force) {
64
- try {
65
- await fs.access(installPath);
66
- return {
67
- success: false,
68
- source: sourceInfo.originalUrl,
69
- sourceType: "github",
70
- pluginType,
71
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
72
- };
73
- } catch {
74
- }
75
- }
76
- if (dryRun) {
77
- const files = await listRepoFiles(owner, repo, actualRef, subpath);
78
- return {
79
- success: true,
80
- source: sourceInfo.originalUrl,
81
- sourceType: "github",
82
- pluginType,
83
- installedPath: installPath,
84
- details: {
85
- name: repo,
86
- version: actualRef,
87
- description: repoInfo.description || void 0,
88
- files: files.slice(0, 20)
89
- }
90
- };
91
- }
92
- const tempDir = await downloadRepo(owner, repo, actualRef);
93
- const sourcePath = subpath ? path__default.join(tempDir, subpath) : tempDir;
94
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
95
- await copyDirectory(sourcePath, installPath);
96
- await fs.rm(tempDir, { recursive: true, force: true });
97
- const installedFiles = await listInstalledFiles$1(installPath);
98
- return {
99
- success: true,
100
- source: sourceInfo.originalUrl,
101
- sourceType: "github",
102
- pluginType,
103
- installedPath: installPath,
104
- details: {
105
- name: repo,
106
- version: actualRef,
107
- description: repoInfo.description || void 0,
108
- files: installedFiles
109
- }
110
- };
111
- } catch (error) {
112
- return {
113
- success: false,
114
- source: sourceInfo.originalUrl,
115
- sourceType: "github",
116
- pluginType,
117
- error: error instanceof Error ? error.message : String(error)
118
- };
82
+ return execSync(`git show ${hash} --pretty="" --patch`, {
83
+ cwd,
84
+ encoding: "utf-8",
85
+ maxBuffer: 1024 * 1024 * 10
86
+ // 10MB
87
+ });
88
+ } catch {
89
+ return "";
119
90
  }
120
91
  }
121
- async function fetchRepoInfo(owner, repo) {
122
- const url = `https://api.github.com/repos/${owner}/${repo}`;
123
- const response = await fetch(url, {
124
- headers: {
125
- "Accept": "application/vnd.github.v3+json",
126
- "User-Agent": "ccjk-cli"
92
+ function detectBugType(message, diff) {
93
+ const content = `${message}
94
+ ${diff}`.toLowerCase();
95
+ const patterns = [
96
+ {
97
+ category: "type-safety",
98
+ patterns: [
99
+ /null|undefined|cannot read|typeerror/,
100
+ /类型|空值|未定义/,
101
+ /optional chaining|\?\./,
102
+ /strict.*null|null.*check/
103
+ ]
104
+ },
105
+ {
106
+ category: "error-handling",
107
+ patterns: [
108
+ /try.*catch|exception|throw|error.*handling/,
109
+ /unhandled.*rejection|promise.*reject/,
110
+ /异常|错误处理|捕获/
111
+ ]
112
+ },
113
+ {
114
+ category: "performance",
115
+ patterns: [
116
+ /performance|slow|timeout|memory|leak/,
117
+ /optimize|optimization|cache/,
118
+ /性能|优化|缓存|内存/
119
+ ]
120
+ },
121
+ {
122
+ category: "security",
123
+ patterns: [
124
+ /security|xss|csrf|injection|auth/,
125
+ /vulnerability|exploit|sanitize/,
126
+ /安全|漏洞|注入|认证/
127
+ ]
128
+ },
129
+ {
130
+ category: "race-condition",
131
+ patterns: [
132
+ /race.*condition|concurrent|async.*await/,
133
+ /deadlock|mutex|lock/,
134
+ /竞态|并发|死锁/
135
+ ]
136
+ },
137
+ {
138
+ category: "logic-error",
139
+ patterns: [
140
+ /logic|incorrect|wrong.*result/,
141
+ /逻辑|错误结果|计算错误/
142
+ ]
143
+ },
144
+ {
145
+ category: "api-misuse",
146
+ patterns: [
147
+ /api.*usage|incorrect.*call|wrong.*parameter/,
148
+ /接口|调用错误|参数错误/
149
+ ]
150
+ },
151
+ {
152
+ category: "configuration",
153
+ patterns: [
154
+ /config|setting|environment|env/,
155
+ /配置|环境|设置/
156
+ ]
157
+ },
158
+ {
159
+ category: "dependency",
160
+ patterns: [
161
+ /dependency|package|version|upgrade/,
162
+ /依赖|版本|升级/
163
+ ]
127
164
  }
128
- });
129
- if (!response.ok) {
130
- if (response.status === 404) {
131
- throw new Error(`Repository not found: ${owner}/${repo}`);
165
+ ];
166
+ for (const { category, patterns: categoryPatterns } of patterns) {
167
+ if (categoryPatterns.some((p) => p.test(content))) {
168
+ return category;
132
169
  }
133
- throw new Error(`Failed to fetch repository info: ${response.statusText}`);
134
170
  }
135
- return response.json();
171
+ return "other";
136
172
  }
137
- async function listRepoFiles(owner, repo, ref, subpath) {
138
- const treePath = subpath || "";
139
- const url = `https://api.github.com/repos/${owner}/${repo}/git/trees/${ref}?recursive=1`;
140
- const response = await fetch(url, {
141
- headers: {
142
- "Accept": "application/vnd.github.v3+json",
143
- "User-Agent": "ccjk-cli"
144
- }
145
- });
146
- if (!response.ok) {
147
- return [];
173
+ function detectSeverity(message, diff, files) {
174
+ const content = `${message}
175
+ ${diff}`.toLowerCase();
176
+ if (/critical|crash|data.*loss|security.*vuln/i.test(content) || files.some((f) => /auth|security|payment/i.test(f))) {
177
+ return "critical";
148
178
  }
149
- const data = await response.json();
150
- const files = (data.tree || []).filter((item) => item.type === "blob").map((item) => item.path).filter((filePath) => !treePath || filePath.startsWith(treePath));
151
- return files;
152
- }
153
- async function downloadRepo(owner, repo, ref) {
154
- const zipUrl = `https://github.com/${owner}/${repo}/archive/${ref}.zip`;
155
- const tempDir = path__default.join(os__default.tmpdir(), `ccjk-${repo}-${Date.now()}`);
156
- const zipPath = path__default.join(tempDir, "repo.zip");
157
- await fs.mkdir(tempDir, { recursive: true });
158
- await downloadFile(zipUrl, zipPath);
159
- const extractedDir = await extractZip(zipPath, tempDir);
160
- await fs.unlink(zipPath);
161
- return extractedDir;
179
+ if (/breaking|major|important|urgent/i.test(content) || files.length > 10) {
180
+ return "high";
181
+ }
182
+ if (/moderate|minor.*issue/i.test(content) || files.length > 3) {
183
+ return "medium";
184
+ }
185
+ return "low";
162
186
  }
163
- async function extractZip(zipPath, destDir) {
164
- const { exec } = await import('node:child_process');
165
- const { promisify } = await import('node:util');
166
- const execAsync = promisify(exec);
167
- try {
168
- await execAsync(`unzip -q "${zipPath}" -d "${destDir}"`);
169
- } catch {
170
- try {
171
- await execAsync(`tar -xf "${zipPath}" -C "${destDir}"`);
172
- } catch {
173
- throw new Error("Failed to extract archive. Please ensure unzip or tar is installed.");
187
+ function extractRootCause(message, diff) {
188
+ const causePatterns = [
189
+ /caused by[:\s]+(.+)/i,
190
+ /root cause[:\s]+(.+)/i,
191
+ /because[:\s]+(.+)/i,
192
+ /due to[:\s]+(.+)/i,
193
+ /原因[::]\s*(.+)/,
194
+ /由于\s*(.+)/
195
+ ];
196
+ for (const pattern of causePatterns) {
197
+ const match = message.match(pattern);
198
+ if (match) {
199
+ return match[1].trim();
174
200
  }
175
201
  }
176
- const entries = await fs.readdir(destDir);
177
- const extractedDir = entries.find((entry) => !entry.endsWith(".zip"));
178
- if (!extractedDir) {
179
- throw new Error("Failed to find extracted directory");
202
+ const removedLines = diff.match(/^-[^-].*/gm) || [];
203
+ const addedLines = diff.match(/^\+[^+].*/gm) || [];
204
+ if (removedLines.length > 0 && addedLines.length > 0) {
205
+ return `\u4EE3\u7801\u53D8\u66F4: \u79FB\u9664 ${removedLines.length} \u884C, \u65B0\u589E ${addedLines.length} \u884C`;
180
206
  }
181
- return path__default.join(destDir, extractedDir);
207
+ return "\u9700\u8981\u8FDB\u4E00\u6B65\u5206\u6790";
182
208
  }
183
- async function listInstalledFiles$1(dir) {
184
- const files = [];
185
- async function walk(currentDir, prefix = "") {
186
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
187
- for (const entry of entries) {
188
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
189
- if (entry.isDirectory()) {
190
- await walk(path__default.join(currentDir, entry.name), relativePath);
191
- } else {
192
- files.push(relativePath);
193
- }
194
- }
209
+ function extractSolution(diff) {
210
+ const addedLines = diff.match(/^\+[^+].*/gm) || [];
211
+ if (addedLines.length === 0) {
212
+ return "\u5220\u9664\u4E86\u95EE\u9898\u4EE3\u7801";
213
+ }
214
+ if (addedLines.length <= 5) {
215
+ return addedLines.map((l) => l.substring(1)).join("\n");
195
216
  }
196
- await walk(dir);
197
- return files;
217
+ return `\u65B0\u589E ${addedLines.length} \u884C\u4EE3\u7801\u4FEE\u590D\u95EE\u9898`;
198
218
  }
199
-
200
- async function installFromLocal(sourceInfo, pluginType, options = {}) {
201
- const { force = false, dryRun = false } = options;
202
- const { absolutePath, originalPath } = sourceInfo;
203
- try {
204
- const stat = await fs.stat(absolutePath);
205
- const isFile = stat.isFile();
206
- const isDirectory = stat.isDirectory();
207
- if (!isFile && !isDirectory) {
208
- return {
209
- success: false,
210
- source: originalPath,
211
- sourceType: "local",
212
- pluginType,
213
- error: `Source path is neither a file nor a directory: ${absolutePath}`
214
- };
215
- }
216
- const pluginName = path__default.basename(absolutePath, path__default.extname(absolutePath));
217
- const installPath = getInstallPath(pluginType, pluginName);
218
- if (!force) {
219
- try {
220
- await fs.access(installPath);
221
- return {
222
- success: false,
223
- source: originalPath,
224
- sourceType: "local",
225
- pluginType,
226
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
227
- };
228
- } catch {
229
- }
230
- }
231
- const files = isFile ? [path__default.basename(absolutePath)] : await listFiles(absolutePath);
232
- const pluginInfo = await readPluginInfo(absolutePath, isFile);
233
- if (dryRun) {
234
- return {
235
- success: true,
236
- source: originalPath,
237
- sourceType: "local",
238
- pluginType,
239
- installedPath: installPath,
240
- details: {
241
- name: pluginInfo.name || pluginName,
242
- version: pluginInfo.version,
243
- description: pluginInfo.description,
244
- files
219
+ function generatePreventionSuggestions(bugType, _diff) {
220
+ const suggestions = {
221
+ "type-safety": [
222
+ "\u542F\u7528 TypeScript strict \u6A21\u5F0F",
223
+ "\u4F7F\u7528\u53EF\u9009\u94FE\u64CD\u4F5C\u7B26 (?.) \u8FDB\u884C\u7A7A\u503C\u68C0\u67E5",
224
+ "\u4E3A\u6240\u6709\u5916\u90E8\u6570\u636E\u6DFB\u52A0\u8FD0\u884C\u65F6\u9A8C\u8BC1",
225
+ "\u4F7F\u7528 zod \u6216 io-ts \u8FDB\u884C\u7C7B\u578B\u9A8C\u8BC1"
226
+ ],
227
+ "error-handling": [
228
+ "\u4E3A\u6240\u6709\u5F02\u6B65\u64CD\u4F5C\u6DFB\u52A0 try-catch",
229
+ "\u5B9E\u73B0\u5168\u5C40\u9519\u8BEF\u5904\u7406\u4E2D\u95F4\u4EF6",
230
+ "\u6DFB\u52A0\u9519\u8BEF\u8FB9\u754C\u7EC4\u4EF6 (React)",
231
+ "\u4F7F\u7528 Result \u7C7B\u578B\u66FF\u4EE3\u5F02\u5E38"
232
+ ],
233
+ "performance": [
234
+ "\u6DFB\u52A0\u6027\u80FD\u76D1\u63A7\u548C\u544A\u8B66",
235
+ "\u5B9E\u73B0\u7F13\u5B58\u7B56\u7565",
236
+ "\u4F7F\u7528\u61D2\u52A0\u8F7D\u548C\u4EE3\u7801\u5206\u5272",
237
+ "\u5B9A\u671F\u8FDB\u884C\u6027\u80FD\u6D4B\u8BD5"
238
+ ],
239
+ "security": [
240
+ "\u5B9E\u65BD\u5B89\u5168\u4EE3\u7801\u5BA1\u67E5",
241
+ "\u4F7F\u7528\u5B89\u5168\u626B\u63CF\u5DE5\u5177",
242
+ "\u9075\u5FAA OWASP \u5B89\u5168\u6307\u5357",
243
+ "\u5B9A\u671F\u66F4\u65B0\u4F9D\u8D56"
244
+ ],
245
+ "race-condition": [
246
+ "\u4F7F\u7528\u9002\u5F53\u7684\u9501\u673A\u5236",
247
+ "\u907F\u514D\u5171\u4EAB\u53EF\u53D8\u72B6\u6001",
248
+ "\u4F7F\u7528\u539F\u5B50\u64CD\u4F5C",
249
+ "\u6DFB\u52A0\u5E76\u53D1\u6D4B\u8BD5"
250
+ ],
251
+ "logic-error": [
252
+ "\u589E\u52A0\u5355\u5143\u6D4B\u8BD5\u8986\u76D6",
253
+ "\u5B9E\u65BD\u4EE3\u7801\u5BA1\u67E5",
254
+ "\u6DFB\u52A0\u65AD\u8A00\u548C\u4E0D\u53D8\u91CF\u68C0\u67E5",
255
+ "\u4F7F\u7528\u5F62\u5F0F\u5316\u9A8C\u8BC1\u5DE5\u5177"
256
+ ],
257
+ "api-misuse": [
258
+ "\u5B8C\u5584 API \u6587\u6863",
259
+ "\u6DFB\u52A0\u53C2\u6570\u9A8C\u8BC1",
260
+ "\u63D0\u4F9B\u4F7F\u7528\u793A\u4F8B",
261
+ "\u5B9E\u73B0 API \u7248\u672C\u63A7\u5236"
262
+ ],
263
+ "configuration": [
264
+ "\u4F7F\u7528\u914D\u7F6E\u9A8C\u8BC1",
265
+ "\u63D0\u4F9B\u9ED8\u8BA4\u914D\u7F6E",
266
+ "\u6587\u6863\u5316\u6240\u6709\u914D\u7F6E\u9879",
267
+ "\u5B9E\u73B0\u914D\u7F6E\u70ED\u91CD\u8F7D"
268
+ ],
269
+ "dependency": [
270
+ "\u9501\u5B9A\u4F9D\u8D56\u7248\u672C",
271
+ "\u5B9A\u671F\u66F4\u65B0\u4F9D\u8D56",
272
+ "\u4F7F\u7528\u4F9D\u8D56\u626B\u63CF\u5DE5\u5177",
273
+ "\u6D4B\u8BD5\u4F9D\u8D56\u5347\u7EA7"
274
+ ],
275
+ "memory-leak": [
276
+ "\u5B9E\u73B0\u8D44\u6E90\u6E05\u7406",
277
+ "\u4F7F\u7528\u5185\u5B58\u5206\u6790\u5DE5\u5177",
278
+ "\u907F\u514D\u5FAA\u73AF\u5F15\u7528",
279
+ "\u5B9A\u671F\u8FDB\u884C\u5185\u5B58\u6D4B\u8BD5"
280
+ ],
281
+ "other": [
282
+ "\u589E\u52A0\u6D4B\u8BD5\u8986\u76D6",
283
+ "\u5B9E\u65BD\u4EE3\u7801\u5BA1\u67E5",
284
+ "\u5B8C\u5584\u6587\u6863"
285
+ ]
286
+ };
287
+ return suggestions[bugType] || suggestions.other;
288
+ }
289
+ function generatePostmortem(analyses, existingIds) {
290
+ const grouped = groupByCategory(analyses);
291
+ const reports = [];
292
+ let nextId = getNextId(existingIds);
293
+ for (const [category, categoryAnalyses] of Object.entries(grouped)) {
294
+ const merged = mergeAnalyses(categoryAnalyses);
295
+ for (const analysis of merged) {
296
+ const id = `PM-${String(nextId++).padStart(3, "0")}`;
297
+ const report = {
298
+ id,
299
+ title: generateTitle(analysis),
300
+ severity: analysis.severity,
301
+ category: analysis.bugType,
302
+ status: "active",
303
+ createdAt: (/* @__PURE__ */ new Date()).toISOString(),
304
+ updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
305
+ relatedCommits: [analysis.commit],
306
+ affectedVersions: {
307
+ from: "unknown",
308
+ to: "unknown"
309
+ },
310
+ description: generateDescription(analysis),
311
+ rootCause: [analysis.rootCause],
312
+ solution: {
313
+ description: analysis.solution
314
+ },
315
+ preventionMeasures: analysis.preventionSuggestions,
316
+ aiDirectives: generateAiDirectives(analysis),
317
+ detectionPatterns: generateDetectionPatterns(analysis),
318
+ relatedFiles: analysis.commit.files,
319
+ tags: [category, analysis.severity],
320
+ metadata: {
321
+ generatedBy: "ccjk-postmortem",
322
+ version: "1.0.0"
245
323
  }
246
324
  };
247
- }
248
- if (isFile) {
249
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
250
- if (absolutePath.endsWith(".md")) {
251
- await fs.copyFile(absolutePath, installPath);
252
- } else {
253
- await fs.mkdir(installPath, { recursive: true });
254
- await fs.copyFile(
255
- absolutePath,
256
- path__default.join(installPath, path__default.basename(absolutePath))
257
- );
258
- }
259
- } else {
260
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
261
- await copyDirectory(absolutePath, installPath);
262
- }
263
- const installedFiles = isFile ? [path__default.basename(absolutePath)] : await listFiles(installPath);
264
- return {
265
- success: true,
266
- source: originalPath,
267
- sourceType: "local",
268
- pluginType,
269
- installedPath: installPath,
270
- details: {
271
- name: pluginInfo.name || pluginName,
272
- version: pluginInfo.version,
273
- description: pluginInfo.description,
274
- files: installedFiles
275
- }
276
- };
277
- } catch (error) {
278
- return {
279
- success: false,
280
- source: originalPath,
281
- sourceType: "local",
282
- pluginType,
283
- error: error instanceof Error ? error.message : String(error)
284
- };
285
- }
286
- }
287
- async function listFiles(dir) {
288
- const files = [];
289
- async function walk(currentDir, prefix = "") {
290
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
291
- for (const entry of entries) {
292
- if (entry.name.startsWith(".") || entry.name === "node_modules") {
293
- continue;
294
- }
295
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
296
- if (entry.isDirectory()) {
297
- await walk(path__default.join(currentDir, entry.name), relativePath);
298
- } else {
299
- files.push(relativePath);
300
- }
325
+ reports.push(report);
301
326
  }
302
327
  }
303
- await walk(dir);
304
- return files;
328
+ return reports;
305
329
  }
306
- async function readPluginInfo(sourcePath, isFile) {
307
- if (isFile) {
308
- const name = path__default.basename(sourcePath, path__default.extname(sourcePath));
309
- return { name };
310
- }
311
- try {
312
- const packageJsonPath = path__default.join(sourcePath, "package.json");
313
- const content = await fs.readFile(packageJsonPath, "utf-8");
314
- const packageJson = JSON.parse(content);
315
- return {
316
- name: packageJson.name,
317
- version: packageJson.version,
318
- description: packageJson.description
319
- };
320
- } catch {
321
- }
322
- const metaFiles = ["SKILL.md", "skill.md", "README.md", "readme.md"];
323
- for (const metaFile of metaFiles) {
324
- try {
325
- const metaPath = path__default.join(sourcePath, metaFile);
326
- const content = await fs.readFile(metaPath, "utf-8");
327
- const titleMatch = content.match(/^#\s+(.+)$/m);
328
- if (titleMatch) {
329
- return { name: titleMatch[1].trim() };
330
- }
331
- } catch {
330
+ function groupByCategory(analyses) {
331
+ const grouped = {};
332
+ for (const analysis of analyses) {
333
+ const category = analysis.bugType;
334
+ if (!grouped[category]) {
335
+ grouped[category] = [];
332
336
  }
337
+ grouped[category].push(analysis);
333
338
  }
334
- return {};
339
+ return grouped;
335
340
  }
336
-
337
- const execAsync = promisify(exec);
338
- async function installFromNpm(sourceInfo, pluginType, options = {}) {
339
- const { force = false, dryRun = false } = options;
340
- const { packageName, version } = sourceInfo;
341
- try {
342
- const packageInfo = await fetchPackageInfo(packageName, version);
343
- const packageVersion = version || packageInfo.version;
344
- const shortName = getShortName(packageName);
345
- const installPath = getInstallPath(pluginType, shortName);
346
- if (!force) {
347
- try {
348
- await fs.access(installPath);
349
- return {
350
- success: false,
351
- source: packageName,
352
- sourceType: "npm",
353
- pluginType,
354
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
355
- };
356
- } catch {
357
- }
358
- }
359
- if (dryRun) {
360
- const files = packageInfo.files || ["(package files)"];
361
- return {
362
- success: true,
363
- source: packageName,
364
- sourceType: "npm",
365
- pluginType,
366
- installedPath: installPath,
367
- details: {
368
- name: packageName,
369
- version: packageVersion,
370
- description: packageInfo.description,
371
- files
372
- }
373
- };
374
- }
375
- if (pluginType === "mcp") {
376
- await installMcpPackage(packageName, packageVersion, installPath);
341
+ function mergeAnalyses(analyses) {
342
+ const merged = [];
343
+ for (const analysis of analyses) {
344
+ const similar = merged.find(
345
+ (m) => calculateFileOverlap(m.commit.files, analysis.commit.files) > 0.5
346
+ );
347
+ if (similar) {
348
+ similar.commit.files = Array.from(/* @__PURE__ */ new Set([...similar.commit.files, ...analysis.commit.files]));
349
+ similar.preventionSuggestions = Array.from(/* @__PURE__ */ new Set([...similar.preventionSuggestions, ...analysis.preventionSuggestions]));
377
350
  } else {
378
- await installGenericPackage(packageName, packageVersion, installPath);
351
+ merged.push({ ...analysis });
379
352
  }
380
- const installedFiles = await listInstalledFiles(installPath);
381
- return {
382
- success: true,
383
- source: packageName,
384
- sourceType: "npm",
385
- pluginType,
386
- installedPath: installPath,
387
- details: {
388
- name: packageName,
389
- version: packageVersion,
390
- description: packageInfo.description,
391
- files: installedFiles
392
- }
393
- };
394
- } catch (error) {
395
- return {
396
- success: false,
397
- source: packageName,
398
- sourceType: "npm",
399
- pluginType,
400
- error: error instanceof Error ? error.message : String(error)
401
- };
402
353
  }
354
+ return merged;
403
355
  }
404
- async function fetchPackageInfo(packageName, version) {
405
- const url = version ? `https://registry.npmjs.org/${packageName}/${version}` : `https://registry.npmjs.org/${packageName}/latest`;
406
- const response = await fetch(url);
407
- if (!response.ok) {
408
- if (response.status === 404) {
409
- throw new Error(`Package not found: ${packageName}`);
410
- }
411
- throw new Error(`Failed to fetch package info: ${response.statusText}`);
412
- }
413
- const data = await response.json();
414
- return {
415
- version: data.version,
416
- description: data.description,
417
- files: data.files
418
- };
356
+ function calculateFileOverlap(files1, files2) {
357
+ const set1 = new Set(files1);
358
+ const set2 = new Set(files2);
359
+ const intersection = Array.from(set1).filter((f) => set2.has(f));
360
+ const union = /* @__PURE__ */ new Set([...files1, ...files2]);
361
+ return intersection.length / union.size;
419
362
  }
420
- function getShortName(packageName) {
421
- if (packageName.startsWith("@")) {
422
- const parts = packageName.split("/");
423
- return parts[1] || packageName;
424
- }
425
- return packageName;
363
+ function getNextId(existingIds) {
364
+ const numbers = existingIds.map((id) => Number.parseInt(id.replace("PM-", ""), 10)).filter((n) => !Number.isNaN(n));
365
+ return numbers.length > 0 ? Math.max(...numbers) + 1 : 1;
426
366
  }
427
- async function installMcpPackage(packageName, version, installPath) {
428
- await fs.mkdir(installPath, { recursive: true });
429
- const packageJson = {
430
- name: `ccjk-mcp-${getShortName(packageName)}`,
431
- version: "1.0.0",
432
- private: true,
433
- dependencies: {
434
- [packageName]: version
435
- }
367
+ function generateTitle(analysis) {
368
+ const categoryTitles = {
369
+ "type-safety": "\u7C7B\u578B\u5B89\u5168\u95EE\u9898",
370
+ "error-handling": "\u9519\u8BEF\u5904\u7406\u7F3A\u5931",
371
+ "performance": "\u6027\u80FD\u95EE\u9898",
372
+ "security": "\u5B89\u5168\u6F0F\u6D1E",
373
+ "race-condition": "\u7ADE\u6001\u6761\u4EF6",
374
+ "logic-error": "\u903B\u8F91\u9519\u8BEF",
375
+ "api-misuse": "API \u4F7F\u7528\u4E0D\u5F53",
376
+ "configuration": "\u914D\u7F6E\u95EE\u9898",
377
+ "dependency": "\u4F9D\u8D56\u95EE\u9898",
378
+ "memory-leak": "\u5185\u5B58\u6CC4\u6F0F",
379
+ "other": "\u5176\u4ED6\u95EE\u9898"
436
380
  };
437
- await fs.writeFile(
438
- path__default.join(installPath, "package.json"),
439
- JSON.stringify(packageJson, null, 2)
440
- );
441
- try {
442
- await execAsync("npm install", { cwd: installPath });
443
- } catch (error) {
444
- try {
445
- await execAsync("pnpm install", { cwd: installPath });
446
- } catch {
447
- throw new Error(
448
- `Failed to install package. Original error: ${error instanceof Error ? error.message : String(error)}`
449
- );
450
- }
381
+ const baseTitle = categoryTitles[analysis.bugType] || "\u672A\u5206\u7C7B\u95EE\u9898";
382
+ const message = analysis.commit.message;
383
+ const specificPart = message.replace(/^(fix|bugfix|hotfix)[(:]\s*/i, "").split("\n")[0];
384
+ if (specificPart && specificPart.length < 50) {
385
+ return `${baseTitle}: ${specificPart}`;
451
386
  }
387
+ return baseTitle;
452
388
  }
453
- async function installGenericPackage(packageName, version, installPath) {
454
- const registryUrl = `https://registry.npmjs.org/${packageName}/${version}`;
455
- const response = await fetch(registryUrl);
456
- if (!response.ok) {
457
- throw new Error(`Failed to fetch package info: ${response.statusText}`);
458
- }
459
- const data = await response.json();
460
- const tarballUrl = data.dist?.tarball;
461
- if (!tarballUrl) {
462
- throw new Error("Failed to get tarball URL");
463
- }
464
- const tarballResponse = await fetch(tarballUrl);
465
- if (!tarballResponse.ok) {
466
- throw new Error(`Failed to download tarball: ${tarballResponse.statusText}`);
467
- }
468
- await fs.mkdir(installPath, { recursive: true });
469
- const tarballBuffer = Buffer.from(await tarballResponse.arrayBuffer());
470
- const tarballPath = path__default.join(installPath, "package.tgz");
471
- await fs.writeFile(tarballPath, tarballBuffer);
472
- try {
473
- await execAsync(`tar -xzf package.tgz --strip-components=1`, { cwd: installPath });
474
- } finally {
475
- await fs.unlink(tarballPath).catch(() => {
476
- });
477
- }
389
+ function generateDescription(analysis) {
390
+ return `
391
+ \u5728 ${analysis.commit.date} \u53D1\u73B0\u5E76\u4FEE\u590D\u4E86\u4E00\u4E2A ${analysis.bugType} \u7C7B\u578B\u7684\u95EE\u9898\u3002
392
+
393
+ **\u63D0\u4EA4\u4FE1\u606F**: ${analysis.commit.message}
394
+
395
+ **\u5F71\u54CD\u6587\u4EF6**:
396
+ ${analysis.commit.files.map((f) => `- ${f}`).join("\n")}
397
+
398
+ **\u6839\u672C\u539F\u56E0**: ${analysis.rootCause}
399
+ `.trim();
478
400
  }
479
- async function listInstalledFiles(dir) {
480
- const files = [];
481
- async function walk(currentDir, prefix = "") {
482
- try {
483
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
484
- for (const entry of entries) {
485
- if (entry.name === "node_modules")
486
- continue;
487
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
488
- if (entry.isDirectory()) {
489
- await walk(path__default.join(currentDir, entry.name), relativePath);
490
- } else {
491
- files.push(relativePath);
492
- }
493
- }
494
- } catch {
401
+ function generateAiDirectives(analysis) {
402
+ const directives = [];
403
+ const categoryDirectives = {
404
+ "type-safety": [
405
+ "\u5904\u7406\u5916\u90E8\u6570\u636E\u65F6\u5FC5\u987B\u8FDB\u884C\u7A7A\u503C\u68C0\u67E5",
406
+ "\u4F7F\u7528 TypeScript \u4E25\u683C\u6A21\u5F0F",
407
+ "\u907F\u514D\u4F7F\u7528 any \u7C7B\u578B"
408
+ ],
409
+ "error-handling": [
410
+ "\u6240\u6709\u5F02\u6B65\u64CD\u4F5C\u5FC5\u987B\u6709\u9519\u8BEF\u5904\u7406",
411
+ "\u63D0\u4F9B\u6709\u610F\u4E49\u7684\u9519\u8BEF\u6D88\u606F",
412
+ "\u5B9E\u73B0\u4F18\u96C5\u964D\u7EA7"
413
+ ],
414
+ "performance": [
415
+ "\u907F\u514D\u5728\u5FAA\u73AF\u4E2D\u8FDB\u884C I/O \u64CD\u4F5C",
416
+ "\u4F7F\u7528\u9002\u5F53\u7684\u7F13\u5B58\u7B56\u7565",
417
+ "\u6CE8\u610F\u5927\u6570\u636E\u96C6\u7684\u5904\u7406"
418
+ ],
419
+ "security": [
420
+ "\u9A8C\u8BC1\u6240\u6709\u7528\u6237\u8F93\u5165",
421
+ "\u4F7F\u7528\u53C2\u6570\u5316\u67E5\u8BE2",
422
+ "\u4E0D\u8981\u5728\u65E5\u5FD7\u4E2D\u8BB0\u5F55\u654F\u611F\u4FE1\u606F"
423
+ ],
424
+ "race-condition": [
425
+ "\u6CE8\u610F\u5F02\u6B65\u64CD\u4F5C\u7684\u6267\u884C\u987A\u5E8F",
426
+ "\u4F7F\u7528\u9002\u5F53\u7684\u540C\u6B65\u673A\u5236",
427
+ "\u907F\u514D\u5171\u4EAB\u53EF\u53D8\u72B6\u6001"
428
+ ],
429
+ "logic-error": [
430
+ "\u6DFB\u52A0\u8FB9\u754C\u6761\u4EF6\u68C0\u67E5",
431
+ "\u4F7F\u7528\u65AD\u8A00\u9A8C\u8BC1\u5047\u8BBE",
432
+ "\u7F16\u5199\u5355\u5143\u6D4B\u8BD5\u8986\u76D6\u8FB9\u754C\u60C5\u51B5"
433
+ ],
434
+ "api-misuse": [
435
+ "\u67E5\u9605 API \u6587\u6863\u786E\u8BA4\u6B63\u786E\u7528\u6CD5",
436
+ "\u68C0\u67E5\u53C2\u6570\u7C7B\u578B\u548C\u8303\u56F4",
437
+ "\u5904\u7406\u6240\u6709\u53EF\u80FD\u7684\u8FD4\u56DE\u503C"
438
+ ],
439
+ "configuration": [
440
+ "\u63D0\u4F9B\u5408\u7406\u7684\u9ED8\u8BA4\u503C",
441
+ "\u9A8C\u8BC1\u914D\u7F6E\u503C\u7684\u6709\u6548\u6027",
442
+ "\u6587\u6863\u5316\u914D\u7F6E\u9009\u9879"
443
+ ],
444
+ "dependency": [
445
+ "\u68C0\u67E5\u4F9D\u8D56\u7684\u517C\u5BB9\u6027",
446
+ "\u9605\u8BFB\u66F4\u65B0\u65E5\u5FD7",
447
+ "\u5728\u5347\u7EA7\u524D\u8FDB\u884C\u6D4B\u8BD5"
448
+ ],
449
+ "memory-leak": [
450
+ "\u53CA\u65F6\u6E05\u7406\u4E0D\u518D\u4F7F\u7528\u7684\u8D44\u6E90",
451
+ "\u907F\u514D\u5FAA\u73AF\u5F15\u7528",
452
+ "\u4F7F\u7528 WeakMap/WeakSet"
453
+ ],
454
+ "other": [
455
+ "\u4ED4\u7EC6\u5BA1\u67E5\u4EE3\u7801\u53D8\u66F4",
456
+ "\u6DFB\u52A0\u9002\u5F53\u7684\u6D4B\u8BD5"
457
+ ]
458
+ };
459
+ directives.push(...categoryDirectives[analysis.bugType] || categoryDirectives.other);
460
+ for (const file of analysis.commit.files) {
461
+ if (file.includes("api") || file.includes("service")) {
462
+ directives.push(`\u4FEE\u6539 ${path.basename(file)} \u65F6\u6CE8\u610F API \u517C\u5BB9\u6027`);
463
+ }
464
+ if (file.includes("config")) {
465
+ directives.push(`\u4FEE\u6539\u914D\u7F6E\u6587\u4EF6\u65F6\u786E\u4FDD\u5411\u540E\u517C\u5BB9`);
495
466
  }
496
467
  }
497
- await walk(dir);
498
- return files;
468
+ return Array.from(new Set(directives));
499
469
  }
470
+ function generateDetectionPatterns(analysis) {
471
+ const patterns = [];
472
+ const categoryPatterns = {
473
+ "type-safety": [
474
+ {
475
+ type: "regex",
476
+ pattern: "\\.\\w+\\.\\w+\\.\\w+(?!\\?)",
477
+ description: "\u8FDE\u7EED\u5C5E\u6027\u8BBF\u95EE\u672A\u4F7F\u7528\u53EF\u9009\u94FE",
478
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
479
+ severity: "medium"
480
+ },
481
+ {
482
+ type: "regex",
483
+ pattern: "as any",
484
+ description: "\u4F7F\u7528 any \u7C7B\u578B\u65AD\u8A00",
485
+ fileTypes: [".ts", ".tsx"],
486
+ severity: "low"
487
+ }
488
+ ],
489
+ "error-handling": [
490
+ {
491
+ type: "regex",
492
+ pattern: "catch\\s*\\(\\s*\\w*\\s*\\)\\s*\\{\\s*\\}",
493
+ description: "\u7A7A\u7684 catch \u5757",
494
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
495
+ severity: "high"
496
+ },
497
+ {
498
+ type: "regex",
499
+ pattern: "\\.then\\([^)]+\\)(?!\\.catch)",
500
+ description: "Promise \u672A\u5904\u7406 rejection",
501
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
502
+ severity: "medium"
503
+ }
504
+ ],
505
+ "performance": [
506
+ {
507
+ type: "regex",
508
+ pattern: "for\\s*\\([^)]+\\)\\s*\\{[^}]*await",
509
+ description: "\u5FAA\u73AF\u4E2D\u4F7F\u7528 await",
510
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
511
+ severity: "medium"
512
+ }
513
+ ],
514
+ "security": [
515
+ {
516
+ type: "regex",
517
+ pattern: "innerHTML\\s*=",
518
+ description: "\u76F4\u63A5\u8BBE\u7F6E innerHTML \u53EF\u80FD\u5BFC\u81F4 XSS",
519
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
520
+ severity: "high"
521
+ },
522
+ {
523
+ type: "regex",
524
+ pattern: "eval\\s*\\(",
525
+ description: "\u4F7F\u7528 eval \u5B58\u5728\u5B89\u5168\u98CE\u9669",
526
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
527
+ severity: "critical"
528
+ }
529
+ ],
530
+ "race-condition": [],
531
+ "logic-error": [],
532
+ "api-misuse": [],
533
+ "configuration": [],
534
+ "dependency": [],
535
+ "memory-leak": [
536
+ {
537
+ type: "regex",
538
+ pattern: "addEventListener\\([^)]+\\)(?![\\s\\S]*removeEventListener)",
539
+ description: "\u6DFB\u52A0\u4E8B\u4EF6\u76D1\u542C\u5668\u4F46\u672A\u79FB\u9664",
540
+ fileTypes: [".ts", ".tsx", ".js", ".jsx"],
541
+ severity: "medium"
542
+ }
543
+ ],
544
+ "other": []
545
+ };
546
+ patterns.push(...categoryPatterns[analysis.bugType] || []);
547
+ return patterns;
548
+ }
549
+ const PostmortemAnalyzer = {
550
+ getFixCommits,
551
+ analyzeFixCommit,
552
+ generatePostmortem
553
+ };
500
554
 
501
- function parseSource(source) {
502
- const trimmed = source.trim();
503
- const githubInfo = parseGitHubSource(trimmed);
504
- if (githubInfo) {
505
- return githubInfo;
555
+ const DEFAULT_CONFIG = {
556
+ enabled: true,
557
+ directory: "./postmortem",
558
+ autoSyncToClaudeMd: true,
559
+ maxSyncItems: 10,
560
+ minSyncSeverity: "medium",
561
+ detection: {
562
+ enabled: true,
563
+ excludePatterns: ["node_modules/**", "dist/**", "*.test.*", "*.spec.*"],
564
+ includePatterns: ["src/**/*.ts", "src/**/*.tsx"]
565
+ },
566
+ aiAnalysis: {
567
+ provider: "claude"
506
568
  }
507
- const localInfo = parseLocalSource(trimmed);
508
- if (localInfo) {
509
- return localInfo;
569
+ };
570
+ const INDEX_FILE = "index.json";
571
+ const CLAUDE_MD_SECTION_START = "<!-- POSTMORTEM_START -->";
572
+ const CLAUDE_MD_SECTION_END = "<!-- POSTMORTEM_END -->";
573
+ class PostmortemManager {
574
+ config;
575
+ projectRoot;
576
+ postmortemDir;
577
+ constructor(projectRoot = process.cwd(), config = {}) {
578
+ this.projectRoot = projectRoot;
579
+ this.config = { ...DEFAULT_CONFIG, ...config };
580
+ this.postmortemDir = path.join(projectRoot, this.config.directory);
510
581
  }
511
- return parseNpmSource(trimmed);
512
- }
513
- function parseGitHubSource(source) {
514
- const prefixMatch = source.match(/^(?:github|gh):([^/]+)\/([^#@/]+)(?:#(.+))?$/);
515
- if (prefixMatch) {
516
- return {
517
- type: "github",
518
- owner: prefixMatch[1],
519
- repo: prefixMatch[2],
520
- ref: prefixMatch[3],
521
- originalUrl: source
522
- };
582
+ // ==========================================================================
583
+ // Initialization
584
+ // ==========================================================================
585
+ /**
586
+ * 初始化 Postmortem 系统
587
+ */
588
+ async init() {
589
+ this.ensureDirectories();
590
+ const commits = PostmortemAnalyzer.getFixCommits({
591
+ limit: 200,
592
+ cwd: this.projectRoot
593
+ });
594
+ if (commits.length === 0) {
595
+ this.saveIndex(this.createEmptyIndex());
596
+ return { created: 0, directory: this.postmortemDir };
597
+ }
598
+ const analyses = commits.map(
599
+ (commit) => PostmortemAnalyzer.analyzeFixCommit(commit, this.projectRoot)
600
+ );
601
+ const reports = PostmortemAnalyzer.generatePostmortem(analyses, []);
602
+ for (const report of reports) {
603
+ this.saveReport(report);
604
+ }
605
+ this.updateIndex();
606
+ if (this.config.autoSyncToClaudeMd) {
607
+ await this.syncToClaudeMd();
608
+ }
609
+ return { created: reports.length, directory: this.postmortemDir };
523
610
  }
524
- const urlMatch = source.match(
525
- /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/tree\/([^/]+))?(?:\/(.+))?$/
526
- );
527
- if (urlMatch) {
528
- return {
529
- type: "github",
530
- owner: urlMatch[1],
531
- repo: urlMatch[2],
532
- ref: urlMatch[3],
533
- subpath: urlMatch[4],
534
- originalUrl: source
535
- };
611
+ /**
612
+ * 确保目录存在
613
+ */
614
+ ensureDirectories() {
615
+ const dirs = [
616
+ this.postmortemDir,
617
+ path.join(this.postmortemDir, "categories"),
618
+ path.join(this.postmortemDir, "summaries")
619
+ ];
620
+ for (const dir of dirs) {
621
+ if (!fs.existsSync(dir)) {
622
+ fs.mkdirSync(dir, { recursive: true });
623
+ }
624
+ }
536
625
  }
537
- const shortMatch = source.match(/^([\w-]+)\/([\w.-]+)(?:#(.+))?$/);
538
- if (shortMatch && !source.startsWith(".") && !source.startsWith("/") && !source.startsWith("~")) {
539
- return {
540
- type: "github",
541
- owner: shortMatch[1],
542
- repo: shortMatch[2],
543
- ref: shortMatch[3],
544
- originalUrl: source
545
- };
626
+ // ==========================================================================
627
+ // Report Management
628
+ // ==========================================================================
629
+ /**
630
+ * 保存 Postmortem 报告
631
+ */
632
+ saveReport(report) {
633
+ const filename = `${report.id}-${this.slugify(report.title)}.md`;
634
+ const filepath = path.join(this.postmortemDir, filename);
635
+ const content = this.renderReportToMarkdown(report);
636
+ fs.writeFileSync(filepath, content, "utf-8");
637
+ const jsonPath = path.join(this.postmortemDir, `${report.id}.json`);
638
+ fs.writeFileSync(jsonPath, JSON.stringify(report, null, 2), "utf-8");
639
+ return filepath;
546
640
  }
547
- return null;
548
- }
549
- function parseLocalSource(source) {
550
- if (source.startsWith("./") || source.startsWith("../") || source.startsWith("/") || source.startsWith("~/")) {
551
- let absolutePath;
552
- if (source.startsWith("~/")) {
553
- absolutePath = path__default.join(os__default.homedir(), source.slice(2));
554
- } else if (path__default.isAbsolute(source)) {
555
- absolutePath = source;
556
- } else {
557
- absolutePath = path__default.resolve(process.cwd(), source);
641
+ /**
642
+ * 读取 Postmortem 报告
643
+ */
644
+ getReport(id) {
645
+ const jsonPath = path.join(this.postmortemDir, `${id}.json`);
646
+ if (!fs.existsSync(jsonPath)) {
647
+ return null;
648
+ }
649
+ try {
650
+ const content = fs.readFileSync(jsonPath, "utf-8");
651
+ return JSON.parse(content);
652
+ } catch {
653
+ return null;
558
654
  }
559
- return {
560
- type: "local",
561
- absolutePath,
562
- originalPath: source
563
- };
564
655
  }
565
- if (/^[a-z]:[\\/]/i.test(source)) {
566
- return {
567
- type: "local",
568
- absolutePath: path__default.resolve(source),
569
- originalPath: source
570
- };
656
+ /**
657
+ * 列出所有 Postmortem
658
+ */
659
+ listReports() {
660
+ const index = this.loadIndex();
661
+ return index?.reports || [];
571
662
  }
572
- return null;
573
- }
574
- function parseNpmSource(source) {
575
- const npmPrefixMatch = source.match(/^npm:(.+)$/);
576
- const packageStr = npmPrefixMatch ? npmPrefixMatch[1] : source;
577
- const scopedMatch = packageStr.match(/^(@[^/]+)\/([^@]+)(?:@(.+))?$/);
578
- if (scopedMatch) {
579
- return {
580
- type: "npm",
581
- scope: scopedMatch[1],
582
- packageName: `${scopedMatch[1]}/${scopedMatch[2]}`,
583
- version: scopedMatch[3]
663
+ /**
664
+ * 渲染报告为 Markdown
665
+ */
666
+ renderReportToMarkdown(report) {
667
+ const severityEmoji = {
668
+ critical: "\u{1F534}",
669
+ high: "\u{1F7E0}",
670
+ medium: "\u{1F7E1}",
671
+ low: "\u{1F7E2}"
584
672
  };
673
+ return `# ${report.id}: ${report.title}
674
+
675
+ ## \u5143\u6570\u636E
676
+ - **ID**: ${report.id}
677
+ - **\u4E25\u91CD\u7A0B\u5EA6**: ${severityEmoji[report.severity]} ${report.severity.toUpperCase()}
678
+ - **\u7C7B\u522B**: ${report.category}
679
+ - **\u72B6\u6001**: ${report.status}
680
+ - **\u521B\u5EFA\u65F6\u95F4**: ${report.createdAt}
681
+ - **\u66F4\u65B0\u65F6\u95F4**: ${report.updatedAt}
682
+
683
+ ## \u76F8\u5173\u63D0\u4EA4
684
+ ${report.relatedCommits.map((c) => `- \`${c.shortHash}\` - ${c.message} (${c.author}, ${c.date})`).join("\n")}
685
+
686
+ ## \u5F71\u54CD\u7248\u672C
687
+ - **\u4ECE**: ${report.affectedVersions.from}
688
+ - **\u5230**: ${report.affectedVersions.to}
689
+
690
+ ## \u95EE\u9898\u63CF\u8FF0
691
+ ${report.description}
692
+
693
+ ## \u6839\u672C\u539F\u56E0
694
+ ${report.rootCause.map((c) => `- ${c}`).join("\n")}
695
+
696
+ ## \u4FEE\u590D\u65B9\u6848
697
+ ${report.solution.description}
698
+
699
+ ${report.solution.codeExample ? `
700
+ ### \u4EE3\u7801\u793A\u4F8B
701
+
702
+ **\u274C \u9519\u8BEF\u5199\u6CD5**
703
+ \`\`\`typescript
704
+ ${report.solution.codeExample.bad}
705
+ \`\`\`
706
+
707
+ **\u2705 \u6B63\u786E\u5199\u6CD5**
708
+ \`\`\`typescript
709
+ ${report.solution.codeExample.good}
710
+ \`\`\`
711
+ ` : ""}
712
+
713
+ ## \u9884\u9632\u63AA\u65BD
714
+ ${report.preventionMeasures.map((m, i) => `${i + 1}. ${m}`).join("\n")}
715
+
716
+ ## AI \u5F00\u53D1\u6307\u4EE4
717
+ > \u4EE5\u4E0B\u6307\u4EE4\u4F1A\u81EA\u52A8\u6CE8\u5165\u5230 CLAUDE.md \u4E2D\uFF0C\u6307\u5BFC AI \u5728\u5F00\u53D1\u65F6\u907F\u514D\u7C7B\u4F3C\u95EE\u9898
718
+
719
+ ${report.aiDirectives.map((d) => `- ${d}`).join("\n")}
720
+
721
+ ## \u68C0\u6D4B\u6A21\u5F0F
722
+ ${report.detectionPatterns.length > 0 ? report.detectionPatterns.map((p) => `
723
+ ### ${p.description}
724
+ - **\u7C7B\u578B**: ${p.type}
725
+ - **\u6A21\u5F0F**: \`${p.pattern}\`
726
+ - **\u9002\u7528\u6587\u4EF6**: ${p.fileTypes.join(", ")}
727
+ - **\u4E25\u91CD\u7A0B\u5EA6**: ${p.severity}
728
+ `).join("\n") : "\u6682\u65E0\u81EA\u52A8\u68C0\u6D4B\u6A21\u5F0F"}
729
+
730
+ ## \u76F8\u5173\u6587\u4EF6
731
+ ${report.relatedFiles.map((f) => `- \`${f}\``).join("\n")}
732
+
733
+ ## \u6807\u7B7E
734
+ ${report.tags.map((t) => `\`${t}\``).join(" ")}
735
+
736
+ ---
737
+ *\u7531 CCJK Postmortem System \u81EA\u52A8\u751F\u6210*
738
+ `;
739
+ }
740
+ /**
741
+ * 生成 slug
742
+ */
743
+ slugify(text) {
744
+ return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").substring(0, 50);
585
745
  }
586
- const versionMatch = packageStr.match(/^([^@]+)@(.+)$/);
587
- if (versionMatch) {
746
+ // ==========================================================================
747
+ // Index Management
748
+ // ==========================================================================
749
+ /**
750
+ * 创建空索引
751
+ */
752
+ createEmptyIndex() {
588
753
  return {
589
- type: "npm",
590
- packageName: versionMatch[1],
591
- version: versionMatch[2]
754
+ version: "1.0.0",
755
+ lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
756
+ stats: {
757
+ total: 0,
758
+ bySeverity: { critical: 0, high: 0, medium: 0, low: 0 },
759
+ byCategory: {
760
+ "type-safety": 0,
761
+ "error-handling": 0,
762
+ "performance": 0,
763
+ "security": 0,
764
+ "logic-error": 0,
765
+ "race-condition": 0,
766
+ "memory-leak": 0,
767
+ "api-misuse": 0,
768
+ "configuration": 0,
769
+ "dependency": 0,
770
+ "other": 0
771
+ },
772
+ byStatus: { active: 0, resolved: 0, monitoring: 0, archived: 0 }
773
+ },
774
+ reports: []
592
775
  };
593
776
  }
594
- return {
595
- type: "npm",
596
- packageName: packageStr
597
- };
598
- }
599
- function buildGitHubRawUrl(info, filePath) {
600
- const ref = info.ref || "main";
601
- return `https://raw.githubusercontent.com/${info.owner}/${info.repo}/${ref}/${filePath}`;
602
- }
603
-
604
- async function detectPluginType(sourceInfo) {
605
- const result = await detectPluginTypeWithConfidence(sourceInfo);
606
- return result.type;
607
- }
608
- async function detectPluginTypeWithConfidence(sourceInfo) {
609
- switch (sourceInfo.type) {
610
- case "github":
611
- return detectFromGitHub(sourceInfo);
612
- case "npm":
613
- return detectFromNpm(sourceInfo);
614
- case "local":
615
- return detectFromLocal(sourceInfo);
616
- default:
617
- return { type: "skill", confidence: "low", reason: "Unknown source type" };
618
- }
619
- }
620
- async function detectFromGitHub(info) {
621
- const repoNameResult = detectFromRepoName(info.repo);
622
- if (repoNameResult.confidence === "high") {
623
- return repoNameResult;
624
- }
625
- try {
626
- const packageJsonUrl = buildGitHubRawUrl(info, "package.json");
627
- const response = await fetch(packageJsonUrl);
628
- if (response.ok) {
629
- const packageJson = await response.json();
630
- const pkgResult = detectFromPackageJson(packageJson);
631
- if (pkgResult.confidence !== "low") {
632
- return pkgResult;
633
- }
777
+ /**
778
+ * 加载索引
779
+ */
780
+ loadIndex() {
781
+ const indexPath = path.join(this.postmortemDir, INDEX_FILE);
782
+ if (!fs.existsSync(indexPath)) {
783
+ return null;
634
784
  }
635
- } catch {
636
- }
637
- const filePatterns = [
638
- { file: "SKILL.md", type: "skill" },
639
- { file: "skill.md", type: "skill" },
640
- { file: "AGENT.md", type: "agent" },
641
- { file: "agent.md", type: "agent" },
642
- { file: "mcp.json", type: "mcp" },
643
- { file: "hook.json", type: "hook" }
644
- ];
645
- for (const pattern of filePatterns) {
646
785
  try {
647
- const fileUrl = buildGitHubRawUrl(info, pattern.file);
648
- const response = await fetch(fileUrl, { method: "HEAD" });
649
- if (response.ok) {
650
- return {
651
- type: pattern.type,
652
- confidence: "high",
653
- reason: `Found ${pattern.file}`
654
- };
655
- }
786
+ const content = fs.readFileSync(indexPath, "utf-8");
787
+ return JSON.parse(content);
656
788
  } catch {
789
+ return null;
657
790
  }
658
791
  }
659
- return repoNameResult.confidence !== "low" ? repoNameResult : { type: "skill", confidence: "low", reason: "Default type" };
660
- }
661
- async function detectFromNpm(info) {
662
- const nameResult = detectFromPackageName(info.packageName);
663
- if (nameResult.confidence === "high") {
664
- return nameResult;
792
+ /**
793
+ * 保存索引
794
+ */
795
+ saveIndex(index) {
796
+ const indexPath = path.join(this.postmortemDir, INDEX_FILE);
797
+ fs.writeFileSync(indexPath, JSON.stringify(index, null, 2), "utf-8");
665
798
  }
666
- try {
667
- const registryUrl = `https://registry.npmjs.org/${info.packageName}`;
668
- const response = await fetch(registryUrl);
669
- if (response.ok) {
670
- const data = await response.json();
671
- const latestVersion = data["dist-tags"]?.latest;
672
- if (latestVersion && data.versions?.[latestVersion]) {
673
- const packageJson = data.versions[latestVersion];
674
- const pkgResult = detectFromPackageJson(packageJson);
675
- if (pkgResult.confidence !== "low") {
676
- return pkgResult;
677
- }
799
+ /**
800
+ * 更新索引
801
+ */
802
+ updateIndex() {
803
+ const index = this.createEmptyIndex();
804
+ const files = fs.readdirSync(this.postmortemDir).filter((f) => f.startsWith("PM-") && f.endsWith(".json"));
805
+ for (const file of files) {
806
+ try {
807
+ const content = fs.readFileSync(path.join(this.postmortemDir, file), "utf-8");
808
+ const report = JSON.parse(content);
809
+ index.stats.total++;
810
+ index.stats.bySeverity[report.severity]++;
811
+ index.stats.byCategory[report.category]++;
812
+ index.stats.byStatus[report.status]++;
813
+ index.reports.push({
814
+ id: report.id,
815
+ title: report.title,
816
+ severity: report.severity,
817
+ category: report.category,
818
+ status: report.status,
819
+ createdAt: report.createdAt,
820
+ filePath: file.replace(".json", ".md")
821
+ });
822
+ } catch {
678
823
  }
679
824
  }
680
- } catch {
681
- }
682
- return nameResult.confidence !== "low" ? nameResult : { type: "skill", confidence: "low", reason: "Default type" };
683
- }
684
- async function detectFromLocal(info) {
685
- const { absolutePath } = info;
686
- const dirName = path__default.basename(absolutePath);
687
- const dirResult = detectFromRepoName(dirName);
688
- if (dirResult.confidence === "high") {
689
- return dirResult;
825
+ index.reports.sort((a, b) => {
826
+ const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
827
+ const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];
828
+ if (severityDiff !== 0)
829
+ return severityDiff;
830
+ return new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime();
831
+ });
832
+ index.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
833
+ this.saveIndex(index);
834
+ return index;
690
835
  }
691
- try {
692
- const packageJsonPath = path__default.join(absolutePath, "package.json");
693
- const content = await fs.readFile(packageJsonPath, "utf-8");
694
- const packageJson = JSON.parse(content);
695
- const pkgResult = detectFromPackageJson(packageJson);
696
- if (pkgResult.confidence !== "low") {
697
- return pkgResult;
836
+ // ==========================================================================
837
+ // CLAUDE.md Integration
838
+ // ==========================================================================
839
+ /**
840
+ * 同步到 CLAUDE.md
841
+ */
842
+ async syncToClaudeMd() {
843
+ const claudeMdPath = path.join(this.projectRoot, "CLAUDE.md");
844
+ const injection = this.generateClaudeMdInjection();
845
+ let content = "";
846
+ if (fs.existsSync(claudeMdPath)) {
847
+ content = fs.readFileSync(claudeMdPath, "utf-8");
698
848
  }
699
- } catch {
700
- }
701
- const filePatterns = [
702
- { file: "SKILL.md", type: "skill" },
703
- { file: "skill.md", type: "skill" },
704
- { file: "AGENT.md", type: "agent" },
705
- { file: "agent.md", type: "agent" },
706
- { file: "mcp.json", type: "mcp" },
707
- { file: "hook.json", type: "hook" }
708
- ];
709
- for (const pattern of filePatterns) {
710
- try {
711
- const filePath = path__default.join(absolutePath, pattern.file);
712
- await fs.access(filePath);
713
- return {
714
- type: pattern.type,
715
- confidence: "high",
716
- reason: `Found ${pattern.file}`
717
- };
718
- } catch {
849
+ const startIndex = content.indexOf(CLAUDE_MD_SECTION_START);
850
+ const endIndex = content.indexOf(CLAUDE_MD_SECTION_END);
851
+ if (startIndex !== -1 && endIndex !== -1) {
852
+ content = content.substring(0, startIndex) + content.substring(endIndex + CLAUDE_MD_SECTION_END.length);
719
853
  }
854
+ const injectionContent = `
855
+ ${CLAUDE_MD_SECTION_START}
856
+ ${injection.content}
857
+ ${CLAUDE_MD_SECTION_END}
858
+ `;
859
+ content = `${content.trim()}
860
+
861
+ ${injectionContent.trim()}
862
+ `;
863
+ fs.writeFileSync(claudeMdPath, content, "utf-8");
864
+ return {
865
+ synced: injection.sourcePostmortems.length,
866
+ claudeMdPath
867
+ };
720
868
  }
721
- try {
722
- const stat = await fs.stat(absolutePath);
723
- if (stat.isFile() && absolutePath.endsWith(".md")) {
724
- return {
725
- type: "skill",
726
- confidence: "high",
727
- reason: "Single markdown file"
869
+ /**
870
+ * 生成 CLAUDE.md 注入内容
871
+ */
872
+ generateClaudeMdInjection() {
873
+ const index = this.loadIndex();
874
+ const reports = [];
875
+ if (index) {
876
+ const severityOrder = {
877
+ critical: 0,
878
+ high: 1,
879
+ medium: 2,
880
+ low: 3
728
881
  };
729
- }
730
- } catch {
731
- }
732
- return dirResult.confidence !== "low" ? dirResult : { type: "skill", confidence: "low", reason: "Default type" };
733
- }
734
- function detectFromRepoName(name) {
735
- const lowerName = name.toLowerCase();
736
- if (lowerName.includes("mcp-server") || lowerName.includes("mcp_server") || lowerName.startsWith("mcp-") || lowerName.endsWith("-mcp")) {
737
- return { type: "mcp", confidence: "high", reason: `Name contains MCP pattern: ${name}` };
738
- }
739
- if (lowerName.includes("agent") || lowerName.includes("-agent") || lowerName.endsWith("-agent")) {
740
- return { type: "agent", confidence: "medium", reason: `Name contains agent pattern: ${name}` };
741
- }
742
- if (lowerName.includes("hook") || lowerName.includes("-hook") || lowerName.endsWith("-hook")) {
743
- return { type: "hook", confidence: "medium", reason: `Name contains hook pattern: ${name}` };
744
- }
745
- if (lowerName.includes("skill") || lowerName.includes("-skill") || lowerName.endsWith("-skill")) {
746
- return { type: "skill", confidence: "medium", reason: `Name contains skill pattern: ${name}` };
747
- }
748
- return { type: "skill", confidence: "low", reason: "No pattern matched" };
749
- }
750
- function detectFromPackageName(packageName) {
751
- const lowerName = packageName.toLowerCase();
752
- if (lowerName.startsWith("@modelcontextprotocol/")) {
753
- return { type: "mcp", confidence: "high", reason: "MCP official scope" };
754
- }
755
- if (lowerName.includes("mcp-server") || lowerName.includes("mcp_server")) {
756
- return { type: "mcp", confidence: "high", reason: "MCP server pattern in name" };
757
- }
758
- return detectFromRepoName(packageName);
759
- }
760
- function detectFromPackageJson(packageJson) {
761
- if (packageJson.ccjk && typeof packageJson.ccjk === "object") {
762
- const ccjk = packageJson.ccjk;
763
- if (ccjk.type && typeof ccjk.type === "string") {
764
- const type = ccjk.type;
765
- if (["skill", "mcp", "agent", "hook"].includes(type)) {
766
- return { type, confidence: "high", reason: "Explicit ccjk.type field" };
882
+ const minSeverityOrder = severityOrder[this.config.minSyncSeverity];
883
+ for (const meta of index.reports) {
884
+ if (severityOrder[meta.severity] <= minSeverityOrder && meta.status === "active") {
885
+ const report = this.getReport(meta.id);
886
+ if (report) {
887
+ reports.push(report);
888
+ }
889
+ }
890
+ if (reports.length >= this.config.maxSyncItems) {
891
+ break;
892
+ }
767
893
  }
768
894
  }
769
- }
770
- if (Array.isArray(packageJson.keywords)) {
771
- const keywords = packageJson.keywords;
772
- const keywordMap = {
773
- "mcp-server": "mcp",
774
- "mcp": "mcp",
775
- "model-context-protocol": "mcp",
776
- "ccjk-skill": "skill",
777
- "claude-skill": "skill",
778
- "ccjk-agent": "agent",
779
- "ccjk-hook": "hook"
780
- };
781
- for (const keyword of keywords) {
782
- const type = keywordMap[keyword.toLowerCase()];
783
- if (type) {
784
- return { type, confidence: "high", reason: `Keyword: ${keyword}` };
895
+ const lines = [
896
+ "## \u26A0\uFE0F \u5DF2\u77E5\u95EE\u9898\u9884\u8B66 (Postmortem Intelligence)",
897
+ "",
898
+ "> \u57FA\u4E8E\u5386\u53F2 bug \u5206\u6790\u81EA\u52A8\u751F\u6210\uFF0C\u5E2E\u52A9\u907F\u514D\u91CD\u590D\u72AF\u9519",
899
+ ""
900
+ ];
901
+ if (reports.length === 0) {
902
+ lines.push("\u6682\u65E0\u9700\u8981\u5173\u6CE8\u7684\u95EE\u9898\u3002");
903
+ } else {
904
+ const critical = reports.filter((r) => r.severity === "critical");
905
+ const high = reports.filter((r) => r.severity === "high");
906
+ const medium = reports.filter((r) => r.severity === "medium");
907
+ if (critical.length > 0) {
908
+ lines.push("### \u{1F534} \u4E25\u91CD");
909
+ for (const r of critical) {
910
+ lines.push(`- **${r.id}**: ${r.title}`);
911
+ lines.push(` - ${r.aiDirectives[0] || r.preventionMeasures[0]}`);
912
+ }
913
+ lines.push("");
914
+ }
915
+ if (high.length > 0) {
916
+ lines.push("### \u{1F7E0} \u9AD8\u4F18\u5148\u7EA7");
917
+ for (const r of high) {
918
+ lines.push(`- **${r.id}**: ${r.title}`);
919
+ lines.push(` - ${r.aiDirectives[0] || r.preventionMeasures[0]}`);
920
+ }
921
+ lines.push("");
922
+ }
923
+ if (medium.length > 0) {
924
+ lines.push("### \u{1F7E1} \u4E2D\u4F18\u5148\u7EA7");
925
+ for (const r of medium) {
926
+ lines.push(`- **${r.id}**: ${r.title}`);
927
+ }
928
+ lines.push("");
929
+ }
930
+ lines.push("### \u{1F4CB} \u5F00\u53D1\u6307\u4EE4");
931
+ const allDirectives = /* @__PURE__ */ new Set();
932
+ for (const r of reports.slice(0, 5)) {
933
+ for (const d of r.aiDirectives.slice(0, 2)) {
934
+ allDirectives.add(d);
935
+ }
785
936
  }
937
+ for (const d of allDirectives) {
938
+ lines.push(`- ${d}`);
939
+ }
940
+ lines.push("");
941
+ lines.push(`> \u8BE6\u7EC6\u4FE1\u606F\u8BF7\u67E5\u770B \`${this.config.directory}/\` \u76EE\u5F55`);
786
942
  }
943
+ return {
944
+ sectionId: "postmortem-warnings",
945
+ title: "\u5DF2\u77E5\u95EE\u9898\u9884\u8B66",
946
+ content: lines.join("\n"),
947
+ priority: 100,
948
+ sourcePostmortems: reports.map((r) => r.id),
949
+ lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
950
+ };
787
951
  }
788
- if (packageJson.bin) {
789
- const binKeys = Object.keys(packageJson.bin);
790
- for (const key of binKeys) {
791
- if (key.includes("mcp") || key.includes("server")) {
792
- return { type: "mcp", confidence: "medium", reason: `Binary name: ${key}` };
952
+ // ==========================================================================
953
+ // Code Checking
954
+ // ==========================================================================
955
+ /**
956
+ * 检查代码是否可能触发已知问题
957
+ */
958
+ async checkCode(options = {}) {
959
+ const { files, staged } = options;
960
+ let filesToCheck = [];
961
+ if (files && files.length > 0) {
962
+ filesToCheck = files;
963
+ } else if (staged) {
964
+ filesToCheck = this.getStagedFiles();
965
+ } else {
966
+ filesToCheck = this.getAllSourceFiles();
967
+ }
968
+ const issues = [];
969
+ const index = this.loadIndex();
970
+ if (!index) {
971
+ return this.createEmptyCheckReport(filesToCheck.length);
972
+ }
973
+ const patterns = [];
974
+ for (const meta of index.reports) {
975
+ if (meta.status !== "active")
976
+ continue;
977
+ const report = this.getReport(meta.id);
978
+ if (!report)
979
+ continue;
980
+ for (const pattern of report.detectionPatterns) {
981
+ patterns.push({ pattern, postmortemId: report.id });
793
982
  }
794
983
  }
795
- }
796
- if (typeof packageJson.main === "string") {
797
- const main = packageJson.main.toLowerCase();
798
- if (main.includes("server") || main.includes("mcp")) {
799
- return { type: "mcp", confidence: "low", reason: `Main file: ${packageJson.main}` };
984
+ for (const file of filesToCheck) {
985
+ const fullPath = path.isAbsolute(file) ? file : path.join(this.projectRoot, file);
986
+ if (!fs.existsSync(fullPath))
987
+ continue;
988
+ const content = fs.readFileSync(fullPath, "utf-8");
989
+ const lines = content.split("\n");
990
+ for (const { pattern, postmortemId } of patterns) {
991
+ if (!pattern.fileTypes.some((ft) => file.endsWith(ft))) {
992
+ continue;
993
+ }
994
+ if (pattern.type === "regex") {
995
+ try {
996
+ const regex = new RegExp(pattern.pattern, "g");
997
+ for (let i = 0; i < lines.length; i++) {
998
+ const line = lines[i];
999
+ const matches = line.match(regex);
1000
+ if (matches) {
1001
+ issues.push({
1002
+ file,
1003
+ line: i + 1,
1004
+ column: line.indexOf(matches[0]) + 1,
1005
+ pattern,
1006
+ postmortemId,
1007
+ message: `\u53EF\u80FD\u89E6\u53D1 ${postmortemId}: ${pattern.description}`,
1008
+ suggestion: `\u53C2\u8003 ${this.config.directory}/${postmortemId}.md`
1009
+ });
1010
+ }
1011
+ }
1012
+ } catch {
1013
+ }
1014
+ }
1015
+ }
800
1016
  }
801
- }
802
- return { type: "skill", confidence: "low", reason: "No specific indicators" };
803
- }
804
-
805
- async function addCommand(source, options = {}) {
806
- const { force = false, dryRun = false, json = false, lang = "en" } = options;
807
- const i18n = getI18n(lang);
808
- const spinner = json ? null : ora(i18n.parsing).start();
809
- let sourceInfo;
810
- try {
811
- sourceInfo = parseSource(source);
812
- spinner?.succeed(i18n.parsed(sourceInfo.type));
813
- } catch (error) {
814
- spinner?.fail(i18n.parseFailed);
815
- const result = {
816
- success: false,
817
- source,
818
- sourceType: "local",
819
- pluginType: "skill",
820
- error: error instanceof Error ? error.message : String(error)
1017
+ const summary = {
1018
+ critical: issues.filter((i) => i.pattern.severity === "critical").length,
1019
+ high: issues.filter((i) => i.pattern.severity === "high").length,
1020
+ medium: issues.filter((i) => i.pattern.severity === "medium").length,
1021
+ low: issues.filter((i) => i.pattern.severity === "low").length
1022
+ };
1023
+ return {
1024
+ timestamp: (/* @__PURE__ */ new Date()).toISOString(),
1025
+ filesChecked: filesToCheck.length,
1026
+ issuesFound: issues,
1027
+ summary,
1028
+ passed: summary.critical === 0 && summary.high === 0
821
1029
  };
822
- if (json) {
823
- console.log(JSON.stringify(result, null, 2));
824
- } else {
825
- console.error(a.red(`
826
- ${i18n.error}: ${result.error}
827
- `));
828
- }
829
- return result;
830
1030
  }
831
- let pluginType = options.type;
832
- if (!pluginType) {
833
- spinner?.start(i18n.detectingType);
1031
+ /**
1032
+ * 获取暂存的文件
1033
+ */
1034
+ getStagedFiles() {
834
1035
  try {
835
- pluginType = await detectPluginType(sourceInfo);
836
- spinner?.succeed(i18n.detectedType(pluginType));
1036
+ const output = execSync("git diff --cached --name-only", {
1037
+ cwd: this.projectRoot,
1038
+ encoding: "utf-8"
1039
+ });
1040
+ return output.trim().split("\n").filter(Boolean);
837
1041
  } catch {
838
- spinner?.info(i18n.defaultType);
839
- pluginType = "skill";
1042
+ return [];
840
1043
  }
841
1044
  }
842
- spinner?.start(dryRun ? i18n.previewInstall : i18n.installing);
843
- try {
844
- let result;
845
- switch (sourceInfo.type) {
846
- case "github":
847
- result = await installFromGitHub(sourceInfo, pluginType, { force, dryRun });
848
- break;
849
- case "npm":
850
- result = await installFromNpm(sourceInfo, pluginType, { force, dryRun });
851
- break;
852
- case "local":
853
- result = await installFromLocal(sourceInfo, pluginType, { force, dryRun });
854
- break;
855
- default:
856
- throw new Error(`Unsupported source type: ${sourceInfo.type}`);
857
- }
858
- if (result.success) {
859
- spinner?.succeed(dryRun ? i18n.previewSuccess : i18n.installSuccess);
860
- } else {
861
- spinner?.fail(i18n.installFailed);
862
- }
863
- if (json) {
864
- console.log(JSON.stringify(result, null, 2));
865
- } else if (result.success && !dryRun) {
866
- printSuccessMessage(result, i18n);
867
- } else if (result.success && dryRun) {
868
- printPreviewMessage(result, i18n);
869
- } else {
870
- console.error(a.red(`
871
- ${i18n.error}: ${result.error}
872
- `));
1045
+ /**
1046
+ * 获取所有源文件
1047
+ */
1048
+ getAllSourceFiles() {
1049
+ const files = [];
1050
+ const walk = (dir) => {
1051
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
1052
+ for (const entry of entries) {
1053
+ const fullPath = path.join(dir, entry.name);
1054
+ const relativePath = path.relative(this.projectRoot, fullPath);
1055
+ if (this.config.detection.excludePatterns.some((p) => this.matchGlob(relativePath, p))) {
1056
+ continue;
1057
+ }
1058
+ if (entry.isDirectory()) {
1059
+ walk(fullPath);
1060
+ } else if (entry.isFile()) {
1061
+ if (this.config.detection.includePatterns.some((p) => this.matchGlob(relativePath, p))) {
1062
+ files.push(relativePath);
1063
+ }
1064
+ }
1065
+ }
1066
+ };
1067
+ walk(this.projectRoot);
1068
+ return files;
1069
+ }
1070
+ /**
1071
+ * 简单的 glob 匹配
1072
+ */
1073
+ matchGlob(filepath, pattern) {
1074
+ const regexPattern = pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\?/g, ".");
1075
+ return new RegExp(`^${regexPattern}$`).test(filepath);
1076
+ }
1077
+ /**
1078
+ * 创建空的检查报告
1079
+ */
1080
+ createEmptyCheckReport(filesChecked) {
1081
+ return {
1082
+ timestamp: (/* @__PURE__ */ new Date()).toISOString(),
1083
+ filesChecked,
1084
+ issuesFound: [],
1085
+ summary: { critical: 0, high: 0, medium: 0, low: 0 },
1086
+ passed: true
1087
+ };
1088
+ }
1089
+ // ==========================================================================
1090
+ // Release Summary
1091
+ // ==========================================================================
1092
+ /**
1093
+ * 生成发布摘要
1094
+ */
1095
+ async generateReleaseSummary(options) {
1096
+ const { version, since, until } = options;
1097
+ const commits = PostmortemAnalyzer.getFixCommits({
1098
+ since,
1099
+ until,
1100
+ cwd: this.projectRoot
1101
+ });
1102
+ const analyses = commits.map(
1103
+ (c) => PostmortemAnalyzer.analyzeFixCommit(c, this.projectRoot)
1104
+ );
1105
+ const existingIds = this.listReports().map((r) => r.id);
1106
+ const newReports = PostmortemAnalyzer.generatePostmortem(analyses, existingIds);
1107
+ const newIds = [];
1108
+ for (const report of newReports) {
1109
+ report.affectedVersions = { from: since || "unknown", to: version };
1110
+ this.saveReport(report);
1111
+ newIds.push(report.id);
873
1112
  }
874
- return result;
875
- } catch (error) {
876
- spinner?.fail(i18n.installFailed);
877
- const result = {
878
- success: false,
879
- source,
880
- sourceType: sourceInfo.type,
881
- pluginType,
882
- error: error instanceof Error ? error.message : String(error)
1113
+ this.updateIndex();
1114
+ const summary = {
1115
+ version,
1116
+ releaseDate: (/* @__PURE__ */ new Date()).toISOString(),
1117
+ fixCommitCount: commits.length,
1118
+ newPostmortems: newIds,
1119
+ updatedPostmortems: [],
1120
+ summary: this.generateReleaseSummaryText(commits, newReports),
1121
+ keyLessons: this.extractKeyLessons(newReports)
883
1122
  };
884
- if (json) {
885
- console.log(JSON.stringify(result, null, 2));
886
- } else {
887
- console.error(a.red(`
888
- ${i18n.error}: ${result.error}
889
- `));
1123
+ const summaryPath = path.join(this.postmortemDir, "summaries", `${version}.json`);
1124
+ fs.writeFileSync(summaryPath, JSON.stringify(summary, null, 2), "utf-8");
1125
+ if (this.config.autoSyncToClaudeMd) {
1126
+ await this.syncToClaudeMd();
890
1127
  }
891
- return result;
1128
+ return summary;
892
1129
  }
893
- }
894
- function printSuccessMessage(result, i18n) {
895
- console.log();
896
- console.log(a.green.bold(`\u2713 ${i18n.installed}`));
897
- console.log();
898
- console.log(` ${a.gray(i18n.name)}: ${result.details?.name || result.source}`);
899
- if (result.details?.version) {
900
- console.log(` ${a.gray(i18n.version)}: ${result.details.version}`);
901
- }
902
- console.log(` ${a.gray(i18n.type)}: ${result.pluginType}`);
903
- console.log(` ${a.gray(i18n.path)}: ${result.installedPath}`);
904
- console.log();
905
- console.log(a.cyan(i18n.nextSteps));
906
- switch (result.pluginType) {
907
- case "skill":
908
- console.log(` ${a.gray("\u2022")} ${i18n.skillHint}`);
909
- break;
910
- case "mcp":
911
- console.log(` ${a.gray("\u2022")} ${i18n.mcpHint}`);
912
- break;
913
- case "agent":
914
- console.log(` ${a.gray("\u2022")} ${i18n.agentHint}`);
915
- break;
916
- case "hook":
917
- console.log(` ${a.gray("\u2022")} ${i18n.hookHint}`);
918
- break;
919
- }
920
- console.log();
921
- }
922
- function printPreviewMessage(result, i18n) {
923
- console.log();
924
- console.log(a.yellow.bold(`\u26A1 ${i18n.preview}`));
925
- console.log();
926
- console.log(` ${a.gray(i18n.source)}: ${result.source}`);
927
- console.log(` ${a.gray(i18n.type)}: ${result.pluginType}`);
928
- console.log(` ${a.gray(i18n.target)}: ${result.installedPath}`);
929
- if (result.details?.files?.length) {
930
- console.log(` ${a.gray(i18n.files)}:`);
931
- for (const file of result.details.files.slice(0, 5)) {
932
- console.log(` ${a.gray("\u2022")} ${file}`);
1130
+ /**
1131
+ * 生成发布摘要文本
1132
+ */
1133
+ generateReleaseSummaryText(commits, reports) {
1134
+ const lines = [
1135
+ `\u672C\u6B21\u53D1\u5E03\u5305\u542B ${commits.length} \u4E2A bug \u4FEE\u590D\uFF0C\u751F\u6210\u4E86 ${reports.length} \u4E2A\u65B0\u7684 Postmortem \u62A5\u544A\u3002`,
1136
+ ""
1137
+ ];
1138
+ if (reports.length > 0) {
1139
+ lines.push("\u4E3B\u8981\u95EE\u9898\u7C7B\u578B:");
1140
+ const categories = /* @__PURE__ */ new Map();
1141
+ for (const r of reports) {
1142
+ categories.set(r.category, (categories.get(r.category) || 0) + 1);
1143
+ }
1144
+ for (const [cat, count] of categories) {
1145
+ lines.push(`- ${cat}: ${count} \u4E2A`);
1146
+ }
933
1147
  }
934
- if (result.details.files.length > 5) {
935
- console.log(` ${a.gray("...")} ${i18n.andMore(result.details.files.length - 5)}`);
1148
+ return lines.join("\n");
1149
+ }
1150
+ /**
1151
+ * 提取关键教训
1152
+ */
1153
+ extractKeyLessons(reports) {
1154
+ const lessons = /* @__PURE__ */ new Set();
1155
+ for (const report of reports) {
1156
+ for (const measure of report.preventionMeasures.slice(0, 2)) {
1157
+ lessons.add(measure);
1158
+ }
936
1159
  }
1160
+ return Array.from(lessons).slice(0, 10);
937
1161
  }
938
- console.log();
939
- console.log(a.gray(i18n.dryRunNote));
940
- console.log();
941
1162
  }
942
- function getI18n(lang) {
943
- const texts = {
944
- "zh-CN": {
945
- parsing: "\u89E3\u6790\u6765\u6E90...",
946
- parsed: (type) => `\u6765\u6E90\u7C7B\u578B: ${type}`,
947
- parseFailed: "\u89E3\u6790\u6765\u6E90\u5931\u8D25",
948
- detectingType: "\u68C0\u6D4B\u63D2\u4EF6\u7C7B\u578B...",
949
- detectedType: (type) => `\u68C0\u6D4B\u5230\u7C7B\u578B: ${type}`,
950
- defaultType: "\u4F7F\u7528\u9ED8\u8BA4\u7C7B\u578B: skill",
951
- installing: "\u5B89\u88C5\u4E2D...",
952
- previewInstall: "\u9884\u89C8\u5B89\u88C5...",
953
- installSuccess: "\u5B89\u88C5\u6210\u529F",
954
- previewSuccess: "\u9884\u89C8\u5B8C\u6210",
955
- installFailed: "\u5B89\u88C5\u5931\u8D25",
956
- error: "\u9519\u8BEF",
957
- installed: "\u63D2\u4EF6\u5DF2\u5B89\u88C5",
958
- preview: "\u5B89\u88C5\u9884\u89C8 (dry-run)",
959
- name: "\u540D\u79F0",
960
- version: "\u7248\u672C",
961
- type: "\u7C7B\u578B",
962
- path: "\u8DEF\u5F84",
963
- source: "\u6765\u6E90",
964
- target: "\u76EE\u6807",
965
- files: "\u6587\u4EF6",
966
- nextSteps: "\u4E0B\u4E00\u6B65:",
967
- skillHint: "\u4F7F\u7528 /skill-name \u5728 Claude Code \u4E2D\u8C03\u7528",
968
- mcpHint: "\u8FD0\u884C ccjk mcp status \u67E5\u770B\u72B6\u6001",
969
- agentHint: "\u4F7F\u7528 ccjk agent list \u67E5\u770B\u5DF2\u5B89\u88C5\u7684 agent",
970
- hookHint: "\u8FD0\u884C ccjk hooks list \u67E5\u770B\u5DF2\u5B89\u88C5\u7684 hook",
971
- dryRunNote: "\u8FD9\u662F\u9884\u89C8\u6A21\u5F0F\uFF0C\u672A\u5B9E\u9645\u5B89\u88C5\u3002\u79FB\u9664 --dry-run \u6267\u884C\u5B89\u88C5\u3002",
972
- andMore: (n) => `\u8FD8\u6709 ${n} \u4E2A\u6587\u4EF6`
973
- },
974
- "en": {
975
- parsing: "Parsing source...",
976
- parsed: (type) => `Source type: ${type}`,
977
- parseFailed: "Failed to parse source",
978
- detectingType: "Detecting plugin type...",
979
- detectedType: (type) => `Detected type: ${type}`,
980
- defaultType: "Using default type: skill",
981
- installing: "Installing...",
982
- previewInstall: "Previewing installation...",
983
- installSuccess: "Installation successful",
984
- previewSuccess: "Preview complete",
985
- installFailed: "Installation failed",
986
- error: "Error",
987
- installed: "Plugin installed",
988
- preview: "Installation preview (dry-run)",
989
- name: "Name",
990
- version: "Version",
991
- type: "Type",
992
- path: "Path",
993
- source: "Source",
994
- target: "Target",
995
- files: "Files",
996
- nextSteps: "Next steps:",
997
- skillHint: "Use /skill-name in Claude Code to invoke",
998
- mcpHint: "Run ccjk mcp status to check status",
999
- agentHint: "Use ccjk agent list to see installed agents",
1000
- hookHint: "Run ccjk hooks list to see installed hooks",
1001
- dryRunNote: "This is preview mode, nothing was installed. Remove --dry-run to install.",
1002
- andMore: (n) => `and ${n} more files`
1003
- }
1004
- };
1005
- return texts[lang];
1163
+ let managerInstance = null;
1164
+ function getPostmortemManager(projectRoot, config) {
1165
+ if (!managerInstance || projectRoot) {
1166
+ managerInstance = new PostmortemManager(projectRoot, config);
1167
+ }
1168
+ return managerInstance;
1006
1169
  }
1007
1170
 
1008
- export { addCommand, parseSource };
1171
+ export { PostmortemAnalyzer, PostmortemManager, getPostmortemManager };