ccjk 11.1.2 → 12.0.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 (99) hide show
  1. package/dist/chunks/agent-teams.mjs +1 -1
  2. package/dist/chunks/agent.mjs +1 -1
  3. package/dist/chunks/api-cli.mjs +118 -0
  4. package/dist/chunks/api-providers.mjs +1 -1
  5. package/dist/chunks/api.mjs +8 -759
  6. package/dist/chunks/auto-bootstrap.mjs +1 -1
  7. package/dist/chunks/auto-init.mjs +1 -1
  8. package/dist/chunks/auto-updater.mjs +1 -1
  9. package/dist/chunks/banner.mjs +1 -1
  10. package/dist/chunks/boost.mjs +1 -1
  11. package/dist/chunks/ccjk-agents.mjs +1 -1
  12. package/dist/chunks/ccjk-all.mjs +1 -1
  13. package/dist/chunks/ccjk-config.mjs +1 -1
  14. package/dist/chunks/ccjk-hooks.mjs +1 -1
  15. package/dist/chunks/ccjk-mcp.mjs +1 -1
  16. package/dist/chunks/ccjk-setup.mjs +1 -1
  17. package/dist/chunks/ccjk-skills.mjs +1 -1
  18. package/dist/chunks/ccr.mjs +6 -6
  19. package/dist/chunks/ccu.mjs +1 -1
  20. package/dist/chunks/check-updates.mjs +2 -2
  21. package/dist/chunks/claude-code-config-manager.mjs +2 -2
  22. package/dist/chunks/claude-code-incremental-manager.mjs +2 -2
  23. package/dist/chunks/claude-config.mjs +1 -1
  24. package/dist/chunks/claude-wrapper.mjs +1 -1
  25. package/dist/chunks/codex-config-switch.mjs +1 -1
  26. package/dist/chunks/codex-provider-manager.mjs +1 -1
  27. package/dist/chunks/codex-uninstaller.mjs +1 -1
  28. package/dist/chunks/codex.mjs +1 -1
  29. package/dist/chunks/commands.mjs +1 -1
  30. package/dist/chunks/completion.mjs +1 -1
  31. package/dist/chunks/config-consolidator.mjs +1 -1
  32. package/dist/chunks/config-switch.mjs +2 -2
  33. package/dist/chunks/config.mjs +1 -1
  34. package/dist/chunks/config2.mjs +1 -1
  35. package/dist/chunks/config3.mjs +1 -1
  36. package/dist/chunks/constants.mjs +1 -1
  37. package/dist/chunks/dashboard.mjs +1 -1
  38. package/dist/chunks/doctor.mjs +31 -7
  39. package/dist/chunks/evolution.mjs +1 -1
  40. package/dist/chunks/features.mjs +5 -5
  41. package/dist/chunks/index.mjs +7 -7
  42. package/dist/chunks/index2.mjs +10 -177
  43. package/dist/chunks/index3.mjs +168 -1162
  44. package/dist/chunks/index4.mjs +1076 -910
  45. package/dist/chunks/index5.mjs +947 -137
  46. package/dist/chunks/index6.mjs +167 -635
  47. package/dist/chunks/index7.mjs +663 -0
  48. package/dist/chunks/init.mjs +17 -17
  49. package/dist/chunks/installer.mjs +1 -1
  50. package/dist/chunks/interview.mjs +2 -2
  51. package/dist/chunks/marketplace.mjs +1 -1
  52. package/dist/chunks/mcp-cli.mjs +191 -0
  53. package/dist/chunks/mcp.mjs +2 -2
  54. package/dist/chunks/menu.mjs +3 -3
  55. package/dist/chunks/migrator.mjs +1 -1
  56. package/dist/chunks/monitor.mjs +1 -1
  57. package/dist/chunks/notification.mjs +1 -1
  58. package/dist/chunks/onboarding.mjs +1 -1
  59. package/dist/chunks/package.mjs +1 -1
  60. package/dist/chunks/permission-manager.mjs +1 -1
  61. package/dist/chunks/permissions.mjs +1 -1
  62. package/dist/chunks/persistence-manager.mjs +1 -1
  63. package/dist/chunks/plugin.mjs +1 -1
  64. package/dist/chunks/prompts.mjs +1 -1
  65. package/dist/chunks/providers.mjs +1 -1
  66. package/dist/chunks/quick-actions.mjs +1 -1
  67. package/dist/chunks/quick-setup.mjs +5 -5
  68. package/dist/chunks/remote.mjs +2 -2
  69. package/dist/chunks/silent-updater.mjs +1 -1
  70. package/dist/chunks/simple-config.mjs +1 -1
  71. package/dist/chunks/skill.mjs +1 -1
  72. package/dist/chunks/skills-sync.mjs +1 -1
  73. package/dist/chunks/skills.mjs +1 -1
  74. package/dist/chunks/slash-commands.mjs +2 -2
  75. package/dist/chunks/startup.mjs +1 -1
  76. package/dist/chunks/stats.mjs +1 -1
  77. package/dist/chunks/status.mjs +1 -1
  78. package/dist/chunks/team.mjs +1 -1
  79. package/dist/chunks/thinking.mjs +2 -2
  80. package/dist/chunks/uninstall.mjs +3 -3
  81. package/dist/chunks/update.mjs +4 -4
  82. package/dist/chunks/upgrade-manager.mjs +1 -1
  83. package/dist/chunks/version-checker.mjs +1 -1
  84. package/dist/chunks/vim.mjs +1 -1
  85. package/dist/chunks/zero-config.mjs +1 -1
  86. package/dist/cli.mjs +76 -16
  87. package/dist/index.d.mts +37 -10
  88. package/dist/index.d.ts +37 -10
  89. package/dist/index.mjs +2 -2
  90. package/dist/shared/{ccjk.DB2UYcq0.mjs → ccjk.BOIUTf5z.mjs} +2 -2
  91. package/dist/shared/ccjk.CL4Yat0G.mjs +303 -0
  92. package/dist/shared/{ccjk.CxtuJxaS.mjs → ccjk.CN0edl87.mjs} +1 -1
  93. package/dist/shared/{ccjk.BKoi8-Hy.mjs → ccjk.CrB6OYHv.mjs} +1 -1
  94. package/dist/shared/{ccjk.DVBW2wxp.mjs → ccjk.Dk1HDseQ.mjs} +1 -1
  95. package/dist/shared/ccjk.bhFAMRyc.mjs +460 -0
  96. package/dist/shared/ccjk.cChAaGgT.mjs +88 -0
  97. package/dist/shared/{ccjk.DrMygfCF.mjs → ccjk.j4uut26D.mjs} +1 -1
  98. package/package.json +2 -3
  99. package/dist/shared/ccjk.Cu_R2MbQ.mjs +0 -75
@@ -1,1005 +1,1171 @@
1
- import ansis from 'ansis';
2
- import ora from 'ora';
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';
1
+ import { execSync } from 'node:child_process';
2
+ import * as path from 'node:path';
3
+ import * as process from 'node:process';
4
+ import * as nodeFs from 'node:fs';
8
5
 
9
- function getCcjkConfigDir() {
10
- if (process.env.CCJK_CONFIG_DIR) {
11
- 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 [];
12
18
  }
13
- return path__default.join(os__default.homedir(), ".ccjk");
14
- }
15
- function getInstallPath(pluginType, name) {
16
- const configDir = getCcjkConfigDir();
17
- const typeDir = {
18
- skill: "skills",
19
- mcp: "mcp-servers",
20
- agent: "agents",
21
- hook: "hooks"
22
- }[pluginType];
23
- return path__default.join(configDir, typeDir, name);
24
19
  }
25
- async function copyDirectory(src, dest) {
26
- await fs.mkdir(dest, { recursive: true });
27
- const entries = await fs.readdir(src, { withFileTypes: true });
20
+ function parseGitLog(output) {
21
+ const commits = [];
22
+ const entries = output.trim().split("\n\n");
28
23
  for (const entry of entries) {
29
- const srcPath = path__default.join(src, entry.name);
30
- const destPath = path__default.join(dest, entry.name);
31
- if (entry.isDirectory()) {
32
- await copyDirectory(srcPath, destPath);
33
- } else {
34
- 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
+ });
35
42
  }
36
43
  }
44
+ return commits;
37
45
  }
38
- async function downloadFile(url, destPath) {
39
- const response = await fetch(url, {
40
- headers: {
41
- "User-Agent": "ccjk-cli"
42
- },
43
- redirect: "follow"
44
- });
45
- if (!response.ok) {
46
- throw new Error(`Failed to download: ${response.statusText}`);
47
- }
48
- const buffer = Buffer.from(await response.arrayBuffer());
49
- 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));
50
62
  }
51
-
52
- async function installFromGitHub(sourceInfo, pluginType, options = {}) {
53
- const { force = false, dryRun = false } = options;
54
- 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) {
55
81
  try {
56
- const repoInfo = await fetchRepoInfo(owner, repo);
57
- const defaultBranch = repoInfo.default_branch || "main";
58
- const actualRef = ref || defaultBranch;
59
- const installPath = getInstallPath(pluginType, repo);
60
- if (!force) {
61
- try {
62
- await fs.access(installPath);
63
- return {
64
- success: false,
65
- source: sourceInfo.originalUrl,
66
- sourceType: "github",
67
- pluginType,
68
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
69
- };
70
- } catch {
71
- }
72
- }
73
- if (dryRun) {
74
- const files = await listRepoFiles(owner, repo, actualRef, subpath);
75
- return {
76
- success: true,
77
- source: sourceInfo.originalUrl,
78
- sourceType: "github",
79
- pluginType,
80
- installedPath: installPath,
81
- details: {
82
- name: repo,
83
- version: actualRef,
84
- description: repoInfo.description || void 0,
85
- files: files.slice(0, 20)
86
- }
87
- };
88
- }
89
- const tempDir = await downloadRepo(owner, repo, actualRef);
90
- const sourcePath = subpath ? path__default.join(tempDir, subpath) : tempDir;
91
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
92
- await copyDirectory(sourcePath, installPath);
93
- await fs.rm(tempDir, { recursive: true, force: true });
94
- const installedFiles = await listInstalledFiles$1(installPath);
95
- return {
96
- success: true,
97
- source: sourceInfo.originalUrl,
98
- sourceType: "github",
99
- pluginType,
100
- installedPath: installPath,
101
- details: {
102
- name: repo,
103
- version: actualRef,
104
- description: repoInfo.description || void 0,
105
- files: installedFiles
106
- }
107
- };
108
- } catch (error) {
109
- return {
110
- success: false,
111
- source: sourceInfo.originalUrl,
112
- sourceType: "github",
113
- pluginType,
114
- error: error instanceof Error ? error.message : String(error)
115
- };
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 "";
116
90
  }
117
91
  }
118
- async function fetchRepoInfo(owner, repo) {
119
- const url = `https://api.github.com/repos/${owner}/${repo}`;
120
- const response = await fetch(url, {
121
- headers: {
122
- "Accept": "application/vnd.github.v3+json",
123
- "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
+ ]
124
164
  }
125
- });
126
- if (!response.ok) {
127
- if (response.status === 404) {
128
- 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;
129
169
  }
130
- throw new Error(`Failed to fetch repository info: ${response.statusText}`);
131
170
  }
132
- return response.json();
171
+ return "other";
133
172
  }
134
- async function listRepoFiles(owner, repo, ref, subpath) {
135
- const treePath = subpath || "";
136
- const url = `https://api.github.com/repos/${owner}/${repo}/git/trees/${ref}?recursive=1`;
137
- const response = await fetch(url, {
138
- headers: {
139
- "Accept": "application/vnd.github.v3+json",
140
- "User-Agent": "ccjk-cli"
141
- }
142
- });
143
- if (!response.ok) {
144
- 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";
145
178
  }
146
- const data = await response.json();
147
- const files = (data.tree || []).filter((item) => item.type === "blob").map((item) => item.path).filter((filePath) => !treePath || filePath.startsWith(treePath));
148
- return files;
149
- }
150
- async function downloadRepo(owner, repo, ref) {
151
- const zipUrl = `https://github.com/${owner}/${repo}/archive/${ref}.zip`;
152
- const tempDir = path__default.join(os__default.tmpdir(), `ccjk-${repo}-${Date.now()}`);
153
- const zipPath = path__default.join(tempDir, "repo.zip");
154
- await fs.mkdir(tempDir, { recursive: true });
155
- await downloadFile(zipUrl, zipPath);
156
- const extractedDir = await extractZip(zipPath, tempDir);
157
- await fs.unlink(zipPath);
158
- 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";
159
186
  }
160
- async function extractZip(zipPath, destDir) {
161
- const { exec } = await import('node:child_process');
162
- const { promisify } = await import('node:util');
163
- const execAsync = promisify(exec);
164
- try {
165
- await execAsync(`unzip -q "${zipPath}" -d "${destDir}"`);
166
- } catch {
167
- try {
168
- await execAsync(`tar -xf "${zipPath}" -C "${destDir}"`);
169
- } catch {
170
- 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();
171
200
  }
172
201
  }
173
- const entries = await fs.readdir(destDir);
174
- const extractedDir = entries.find((entry) => !entry.endsWith(".zip"));
175
- if (!extractedDir) {
176
- 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`;
177
206
  }
178
- return path__default.join(destDir, extractedDir);
207
+ return "\u9700\u8981\u8FDB\u4E00\u6B65\u5206\u6790";
179
208
  }
180
- async function listInstalledFiles$1(dir) {
181
- const files = [];
182
- async function walk(currentDir, prefix = "") {
183
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
184
- for (const entry of entries) {
185
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
186
- if (entry.isDirectory()) {
187
- await walk(path__default.join(currentDir, entry.name), relativePath);
188
- } else {
189
- files.push(relativePath);
190
- }
191
- }
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");
192
216
  }
193
- await walk(dir);
194
- return files;
217
+ return `\u65B0\u589E ${addedLines.length} \u884C\u4EE3\u7801\u4FEE\u590D\u95EE\u9898`;
195
218
  }
196
-
197
- async function installFromLocal(sourceInfo, pluginType, options = {}) {
198
- const { force = false, dryRun = false } = options;
199
- const { absolutePath, originalPath } = sourceInfo;
200
- try {
201
- const stat = await fs.stat(absolutePath);
202
- const isFile = stat.isFile();
203
- const isDirectory = stat.isDirectory();
204
- if (!isFile && !isDirectory) {
205
- return {
206
- success: false,
207
- source: originalPath,
208
- sourceType: "local",
209
- pluginType,
210
- error: `Source path is neither a file nor a directory: ${absolutePath}`
211
- };
212
- }
213
- const pluginName = path__default.basename(absolutePath, path__default.extname(absolutePath));
214
- const installPath = getInstallPath(pluginType, pluginName);
215
- if (!force) {
216
- try {
217
- await fs.access(installPath);
218
- return {
219
- success: false,
220
- source: originalPath,
221
- sourceType: "local",
222
- pluginType,
223
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
224
- };
225
- } catch {
226
- }
227
- }
228
- const files = isFile ? [path__default.basename(absolutePath)] : await listFiles(absolutePath);
229
- const pluginInfo = await readPluginInfo(absolutePath, isFile);
230
- if (dryRun) {
231
- return {
232
- success: true,
233
- source: originalPath,
234
- sourceType: "local",
235
- pluginType,
236
- installedPath: installPath,
237
- details: {
238
- name: pluginInfo.name || pluginName,
239
- version: pluginInfo.version,
240
- description: pluginInfo.description,
241
- 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"
242
323
  }
243
324
  };
244
- }
245
- if (isFile) {
246
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
247
- if (absolutePath.endsWith(".md")) {
248
- await fs.copyFile(absolutePath, installPath);
249
- } else {
250
- await fs.mkdir(installPath, { recursive: true });
251
- await fs.copyFile(
252
- absolutePath,
253
- path__default.join(installPath, path__default.basename(absolutePath))
254
- );
255
- }
256
- } else {
257
- await fs.mkdir(path__default.dirname(installPath), { recursive: true });
258
- await copyDirectory(absolutePath, installPath);
259
- }
260
- const installedFiles = isFile ? [path__default.basename(absolutePath)] : await listFiles(installPath);
261
- return {
262
- success: true,
263
- source: originalPath,
264
- sourceType: "local",
265
- pluginType,
266
- installedPath: installPath,
267
- details: {
268
- name: pluginInfo.name || pluginName,
269
- version: pluginInfo.version,
270
- description: pluginInfo.description,
271
- files: installedFiles
272
- }
273
- };
274
- } catch (error) {
275
- return {
276
- success: false,
277
- source: originalPath,
278
- sourceType: "local",
279
- pluginType,
280
- error: error instanceof Error ? error.message : String(error)
281
- };
282
- }
283
- }
284
- async function listFiles(dir) {
285
- const files = [];
286
- async function walk(currentDir, prefix = "") {
287
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
288
- for (const entry of entries) {
289
- if (entry.name.startsWith(".") || entry.name === "node_modules") {
290
- continue;
291
- }
292
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
293
- if (entry.isDirectory()) {
294
- await walk(path__default.join(currentDir, entry.name), relativePath);
295
- } else {
296
- files.push(relativePath);
297
- }
325
+ reports.push(report);
298
326
  }
299
327
  }
300
- await walk(dir);
301
- return files;
328
+ return reports;
302
329
  }
303
- async function readPluginInfo(sourcePath, isFile) {
304
- if (isFile) {
305
- const name = path__default.basename(sourcePath, path__default.extname(sourcePath));
306
- return { name };
307
- }
308
- try {
309
- const packageJsonPath = path__default.join(sourcePath, "package.json");
310
- const content = await fs.readFile(packageJsonPath, "utf-8");
311
- const packageJson = JSON.parse(content);
312
- return {
313
- name: packageJson.name,
314
- version: packageJson.version,
315
- description: packageJson.description
316
- };
317
- } catch {
318
- }
319
- const metaFiles = ["SKILL.md", "skill.md", "README.md", "readme.md"];
320
- for (const metaFile of metaFiles) {
321
- try {
322
- const metaPath = path__default.join(sourcePath, metaFile);
323
- const content = await fs.readFile(metaPath, "utf-8");
324
- const titleMatch = content.match(/^#\s+(.+)$/m);
325
- if (titleMatch) {
326
- return { name: titleMatch[1].trim() };
327
- }
328
- } 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] = [];
329
336
  }
337
+ grouped[category].push(analysis);
330
338
  }
331
- return {};
339
+ return grouped;
332
340
  }
333
-
334
- const execAsync = promisify(exec);
335
- async function installFromNpm(sourceInfo, pluginType, options = {}) {
336
- const { force = false, dryRun = false } = options;
337
- const { packageName, version } = sourceInfo;
338
- try {
339
- const packageInfo = await fetchPackageInfo(packageName, version);
340
- const packageVersion = version || packageInfo.version;
341
- const shortName = getShortName(packageName);
342
- const installPath = getInstallPath(pluginType, shortName);
343
- if (!force) {
344
- try {
345
- await fs.access(installPath);
346
- return {
347
- success: false,
348
- source: packageName,
349
- sourceType: "npm",
350
- pluginType,
351
- error: `Plugin already exists at ${installPath}. Use --force to overwrite.`
352
- };
353
- } catch {
354
- }
355
- }
356
- if (dryRun) {
357
- const files = packageInfo.files || ["(package files)"];
358
- return {
359
- success: true,
360
- source: packageName,
361
- sourceType: "npm",
362
- pluginType,
363
- installedPath: installPath,
364
- details: {
365
- name: packageName,
366
- version: packageVersion,
367
- description: packageInfo.description,
368
- files
369
- }
370
- };
371
- }
372
- if (pluginType === "mcp") {
373
- 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]));
374
350
  } else {
375
- await installGenericPackage(packageName, packageVersion, installPath);
351
+ merged.push({ ...analysis });
376
352
  }
377
- const installedFiles = await listInstalledFiles(installPath);
378
- return {
379
- success: true,
380
- source: packageName,
381
- sourceType: "npm",
382
- pluginType,
383
- installedPath: installPath,
384
- details: {
385
- name: packageName,
386
- version: packageVersion,
387
- description: packageInfo.description,
388
- files: installedFiles
389
- }
390
- };
391
- } catch (error) {
392
- return {
393
- success: false,
394
- source: packageName,
395
- sourceType: "npm",
396
- pluginType,
397
- error: error instanceof Error ? error.message : String(error)
398
- };
399
353
  }
354
+ return merged;
400
355
  }
401
- async function fetchPackageInfo(packageName, version) {
402
- const url = version ? `https://registry.npmjs.org/${packageName}/${version}` : `https://registry.npmjs.org/${packageName}/latest`;
403
- const response = await fetch(url);
404
- if (!response.ok) {
405
- if (response.status === 404) {
406
- throw new Error(`Package not found: ${packageName}`);
407
- }
408
- throw new Error(`Failed to fetch package info: ${response.statusText}`);
409
- }
410
- const data = await response.json();
411
- return {
412
- version: data.version,
413
- description: data.description,
414
- files: data.files
415
- };
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;
416
362
  }
417
- function getShortName(packageName) {
418
- if (packageName.startsWith("@")) {
419
- const parts = packageName.split("/");
420
- return parts[1] || packageName;
421
- }
422
- 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;
423
366
  }
424
- async function installMcpPackage(packageName, version, installPath) {
425
- await fs.mkdir(installPath, { recursive: true });
426
- const packageJson = {
427
- name: `ccjk-mcp-${getShortName(packageName)}`,
428
- version: "1.0.0",
429
- private: true,
430
- dependencies: {
431
- [packageName]: version
432
- }
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"
433
380
  };
434
- await fs.writeFile(
435
- path__default.join(installPath, "package.json"),
436
- JSON.stringify(packageJson, null, 2)
437
- );
438
- try {
439
- await execAsync("npm install", { cwd: installPath });
440
- } catch (error) {
441
- try {
442
- await execAsync("pnpm install", { cwd: installPath });
443
- } catch {
444
- throw new Error(
445
- `Failed to install package. Original error: ${error instanceof Error ? error.message : String(error)}`
446
- );
447
- }
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}`;
448
386
  }
387
+ return baseTitle;
449
388
  }
450
- async function installGenericPackage(packageName, version, installPath) {
451
- const registryUrl = `https://registry.npmjs.org/${packageName}/${version}`;
452
- const response = await fetch(registryUrl);
453
- if (!response.ok) {
454
- throw new Error(`Failed to fetch package info: ${response.statusText}`);
455
- }
456
- const data = await response.json();
457
- const tarballUrl = data.dist?.tarball;
458
- if (!tarballUrl) {
459
- throw new Error("Failed to get tarball URL");
460
- }
461
- const tarballResponse = await fetch(tarballUrl);
462
- if (!tarballResponse.ok) {
463
- throw new Error(`Failed to download tarball: ${tarballResponse.statusText}`);
464
- }
465
- await fs.mkdir(installPath, { recursive: true });
466
- const tarballBuffer = Buffer.from(await tarballResponse.arrayBuffer());
467
- const tarballPath = path__default.join(installPath, "package.tgz");
468
- await fs.writeFile(tarballPath, tarballBuffer);
469
- try {
470
- await execAsync(`tar -xzf package.tgz --strip-components=1`, { cwd: installPath });
471
- } finally {
472
- await fs.unlink(tarballPath).catch(() => {
473
- });
474
- }
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();
475
400
  }
476
- async function listInstalledFiles(dir) {
477
- const files = [];
478
- async function walk(currentDir, prefix = "") {
479
- try {
480
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
481
- for (const entry of entries) {
482
- if (entry.name === "node_modules")
483
- continue;
484
- const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
485
- if (entry.isDirectory()) {
486
- await walk(path__default.join(currentDir, entry.name), relativePath);
487
- } else {
488
- files.push(relativePath);
489
- }
490
- }
491
- } 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`);
492
466
  }
493
467
  }
494
- await walk(dir);
495
- return files;
468
+ return Array.from(new Set(directives));
496
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
+ };
497
554
 
498
- function parseSource(source) {
499
- const trimmed = source.trim();
500
- const githubInfo = parseGitHubSource(trimmed);
501
- if (githubInfo) {
502
- 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"
503
568
  }
504
- const localInfo = parseLocalSource(trimmed);
505
- if (localInfo) {
506
- 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);
507
581
  }
508
- return parseNpmSource(trimmed);
509
- }
510
- function parseGitHubSource(source) {
511
- const prefixMatch = source.match(/^(?:github|gh):([^/]+)\/([^#@/]+)(?:#(.+))?$/);
512
- if (prefixMatch) {
513
- return {
514
- type: "github",
515
- owner: prefixMatch[1],
516
- repo: prefixMatch[2],
517
- ref: prefixMatch[3],
518
- originalUrl: source
519
- };
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 };
520
610
  }
521
- const urlMatch = source.match(
522
- /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/tree\/([^/]+))?(?:\/(.+))?$/
523
- );
524
- if (urlMatch) {
525
- return {
526
- type: "github",
527
- owner: urlMatch[1],
528
- repo: urlMatch[2],
529
- ref: urlMatch[3],
530
- subpath: urlMatch[4],
531
- originalUrl: source
532
- };
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 (!nodeFs.existsSync(dir)) {
622
+ nodeFs.mkdirSync(dir, { recursive: true });
623
+ }
624
+ }
533
625
  }
534
- const shortMatch = source.match(/^([\w-]+)\/([\w.-]+)(?:#(.+))?$/);
535
- if (shortMatch && !source.startsWith(".") && !source.startsWith("/") && !source.startsWith("~")) {
536
- return {
537
- type: "github",
538
- owner: shortMatch[1],
539
- repo: shortMatch[2],
540
- ref: shortMatch[3],
541
- originalUrl: source
542
- };
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
+ nodeFs.writeFileSync(filepath, content, "utf-8");
637
+ const jsonPath = path.join(this.postmortemDir, `${report.id}.json`);
638
+ nodeFs.writeFileSync(jsonPath, JSON.stringify(report, null, 2), "utf-8");
639
+ return filepath;
543
640
  }
544
- return null;
545
- }
546
- function parseLocalSource(source) {
547
- if (source.startsWith("./") || source.startsWith("../") || source.startsWith("/") || source.startsWith("~/")) {
548
- let absolutePath;
549
- if (source.startsWith("~/")) {
550
- absolutePath = path__default.join(os__default.homedir(), source.slice(2));
551
- } else if (path__default.isAbsolute(source)) {
552
- absolutePath = source;
553
- } else {
554
- 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 (!nodeFs.existsSync(jsonPath)) {
647
+ return null;
648
+ }
649
+ try {
650
+ const content = nodeFs.readFileSync(jsonPath, "utf-8");
651
+ return JSON.parse(content);
652
+ } catch {
653
+ return null;
555
654
  }
556
- return {
557
- type: "local",
558
- absolutePath,
559
- originalPath: source
560
- };
561
655
  }
562
- if (/^[a-z]:[\\/]/i.test(source)) {
563
- return {
564
- type: "local",
565
- absolutePath: path__default.resolve(source),
566
- originalPath: source
567
- };
656
+ /**
657
+ * 列出所有 Postmortem
658
+ */
659
+ listReports() {
660
+ const index = this.loadIndex();
661
+ return index?.reports || [];
568
662
  }
569
- return null;
570
- }
571
- function parseNpmSource(source) {
572
- const npmPrefixMatch = source.match(/^npm:(.+)$/);
573
- const packageStr = npmPrefixMatch ? npmPrefixMatch[1] : source;
574
- const scopedMatch = packageStr.match(/^(@[^/]+)\/([^@]+)(?:@(.+))?$/);
575
- if (scopedMatch) {
576
- return {
577
- type: "npm",
578
- scope: scopedMatch[1],
579
- packageName: `${scopedMatch[1]}/${scopedMatch[2]}`,
580
- 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}"
581
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);
582
745
  }
583
- const versionMatch = packageStr.match(/^([^@]+)@(.+)$/);
584
- if (versionMatch) {
746
+ // ==========================================================================
747
+ // Index Management
748
+ // ==========================================================================
749
+ /**
750
+ * 创建空索引
751
+ */
752
+ createEmptyIndex() {
585
753
  return {
586
- type: "npm",
587
- packageName: versionMatch[1],
588
- 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: []
589
775
  };
590
776
  }
591
- return {
592
- type: "npm",
593
- packageName: packageStr
594
- };
595
- }
596
- function buildGitHubRawUrl(info, filePath) {
597
- const ref = info.ref || "main";
598
- return `https://raw.githubusercontent.com/${info.owner}/${info.repo}/${ref}/${filePath}`;
599
- }
600
-
601
- async function detectPluginType(sourceInfo) {
602
- const result = await detectPluginTypeWithConfidence(sourceInfo);
603
- return result.type;
604
- }
605
- async function detectPluginTypeWithConfidence(sourceInfo) {
606
- switch (sourceInfo.type) {
607
- case "github":
608
- return detectFromGitHub(sourceInfo);
609
- case "npm":
610
- return detectFromNpm(sourceInfo);
611
- case "local":
612
- return detectFromLocal(sourceInfo);
613
- default:
614
- return { type: "skill", confidence: "low", reason: "Unknown source type" };
615
- }
616
- }
617
- async function detectFromGitHub(info) {
618
- const repoNameResult = detectFromRepoName(info.repo);
619
- if (repoNameResult.confidence === "high") {
620
- return repoNameResult;
621
- }
622
- try {
623
- const packageJsonUrl = buildGitHubRawUrl(info, "package.json");
624
- const response = await fetch(packageJsonUrl);
625
- if (response.ok) {
626
- const packageJson = await response.json();
627
- const pkgResult = detectFromPackageJson(packageJson);
628
- if (pkgResult.confidence !== "low") {
629
- return pkgResult;
630
- }
777
+ /**
778
+ * 加载索引
779
+ */
780
+ loadIndex() {
781
+ const indexPath = path.join(this.postmortemDir, INDEX_FILE);
782
+ if (!nodeFs.existsSync(indexPath)) {
783
+ return null;
631
784
  }
632
- } catch {
633
- }
634
- const filePatterns = [
635
- { file: "SKILL.md", type: "skill" },
636
- { file: "skill.md", type: "skill" },
637
- { file: "AGENT.md", type: "agent" },
638
- { file: "agent.md", type: "agent" },
639
- { file: "mcp.json", type: "mcp" },
640
- { file: "hook.json", type: "hook" }
641
- ];
642
- for (const pattern of filePatterns) {
643
785
  try {
644
- const fileUrl = buildGitHubRawUrl(info, pattern.file);
645
- const response = await fetch(fileUrl, { method: "HEAD" });
646
- if (response.ok) {
647
- return {
648
- type: pattern.type,
649
- confidence: "high",
650
- reason: `Found ${pattern.file}`
651
- };
652
- }
786
+ const content = nodeFs.readFileSync(indexPath, "utf-8");
787
+ return JSON.parse(content);
653
788
  } catch {
789
+ return null;
654
790
  }
655
791
  }
656
- return repoNameResult.confidence !== "low" ? repoNameResult : { type: "skill", confidence: "low", reason: "Default type" };
657
- }
658
- async function detectFromNpm(info) {
659
- const nameResult = detectFromPackageName(info.packageName);
660
- if (nameResult.confidence === "high") {
661
- return nameResult;
792
+ /**
793
+ * 保存索引
794
+ */
795
+ saveIndex(index) {
796
+ const indexPath = path.join(this.postmortemDir, INDEX_FILE);
797
+ nodeFs.writeFileSync(indexPath, JSON.stringify(index, null, 2), "utf-8");
662
798
  }
663
- try {
664
- const registryUrl = `https://registry.npmjs.org/${info.packageName}`;
665
- const response = await fetch(registryUrl);
666
- if (response.ok) {
667
- const data = await response.json();
668
- const latestVersion = data["dist-tags"]?.latest;
669
- if (latestVersion && data.versions?.[latestVersion]) {
670
- const packageJson = data.versions[latestVersion];
671
- const pkgResult = detectFromPackageJson(packageJson);
672
- if (pkgResult.confidence !== "low") {
673
- return pkgResult;
674
- }
799
+ /**
800
+ * 更新索引
801
+ */
802
+ updateIndex() {
803
+ const index = this.createEmptyIndex();
804
+ const files = nodeFs.readdirSync(this.postmortemDir).filter((f) => f.startsWith("PM-") && f.endsWith(".json"));
805
+ for (const file of files) {
806
+ try {
807
+ const content = nodeFs.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 {
675
823
  }
676
824
  }
677
- } catch {
678
- }
679
- return nameResult.confidence !== "low" ? nameResult : { type: "skill", confidence: "low", reason: "Default type" };
680
- }
681
- async function detectFromLocal(info) {
682
- const { absolutePath } = info;
683
- const dirName = path__default.basename(absolutePath);
684
- const dirResult = detectFromRepoName(dirName);
685
- if (dirResult.confidence === "high") {
686
- 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;
687
835
  }
688
- try {
689
- const packageJsonPath = path__default.join(absolutePath, "package.json");
690
- const content = await fs.readFile(packageJsonPath, "utf-8");
691
- const packageJson = JSON.parse(content);
692
- const pkgResult = detectFromPackageJson(packageJson);
693
- if (pkgResult.confidence !== "low") {
694
- 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 (nodeFs.existsSync(claudeMdPath)) {
847
+ content = nodeFs.readFileSync(claudeMdPath, "utf-8");
695
848
  }
696
- } catch {
697
- }
698
- const filePatterns = [
699
- { file: "SKILL.md", type: "skill" },
700
- { file: "skill.md", type: "skill" },
701
- { file: "AGENT.md", type: "agent" },
702
- { file: "agent.md", type: "agent" },
703
- { file: "mcp.json", type: "mcp" },
704
- { file: "hook.json", type: "hook" }
705
- ];
706
- for (const pattern of filePatterns) {
707
- try {
708
- const filePath = path__default.join(absolutePath, pattern.file);
709
- await fs.access(filePath);
710
- return {
711
- type: pattern.type,
712
- confidence: "high",
713
- reason: `Found ${pattern.file}`
714
- };
715
- } 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);
716
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
+ nodeFs.writeFileSync(claudeMdPath, content, "utf-8");
864
+ return {
865
+ synced: injection.sourcePostmortems.length,
866
+ claudeMdPath
867
+ };
717
868
  }
718
- try {
719
- const stat = await fs.stat(absolutePath);
720
- if (stat.isFile() && absolutePath.endsWith(".md")) {
721
- return {
722
- type: "skill",
723
- confidence: "high",
724
- 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
725
881
  };
726
- }
727
- } catch {
728
- }
729
- return dirResult.confidence !== "low" ? dirResult : { type: "skill", confidence: "low", reason: "Default type" };
730
- }
731
- function detectFromRepoName(name) {
732
- const lowerName = name.toLowerCase();
733
- if (lowerName.includes("mcp-server") || lowerName.includes("mcp_server") || lowerName.startsWith("mcp-") || lowerName.endsWith("-mcp")) {
734
- return { type: "mcp", confidence: "high", reason: `Name contains MCP pattern: ${name}` };
735
- }
736
- if (lowerName.includes("agent") || lowerName.includes("-agent") || lowerName.endsWith("-agent")) {
737
- return { type: "agent", confidence: "medium", reason: `Name contains agent pattern: ${name}` };
738
- }
739
- if (lowerName.includes("hook") || lowerName.includes("-hook") || lowerName.endsWith("-hook")) {
740
- return { type: "hook", confidence: "medium", reason: `Name contains hook pattern: ${name}` };
741
- }
742
- if (lowerName.includes("skill") || lowerName.includes("-skill") || lowerName.endsWith("-skill")) {
743
- return { type: "skill", confidence: "medium", reason: `Name contains skill pattern: ${name}` };
744
- }
745
- return { type: "skill", confidence: "low", reason: "No pattern matched" };
746
- }
747
- function detectFromPackageName(packageName) {
748
- const lowerName = packageName.toLowerCase();
749
- if (lowerName.startsWith("@modelcontextprotocol/")) {
750
- return { type: "mcp", confidence: "high", reason: "MCP official scope" };
751
- }
752
- if (lowerName.includes("mcp-server") || lowerName.includes("mcp_server")) {
753
- return { type: "mcp", confidence: "high", reason: "MCP server pattern in name" };
754
- }
755
- return detectFromRepoName(packageName);
756
- }
757
- function detectFromPackageJson(packageJson) {
758
- if (packageJson.ccjk && typeof packageJson.ccjk === "object") {
759
- const ccjk = packageJson.ccjk;
760
- if (ccjk.type && typeof ccjk.type === "string") {
761
- const type = ccjk.type;
762
- if (["skill", "mcp", "agent", "hook"].includes(type)) {
763
- 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
+ }
764
893
  }
765
894
  }
766
- }
767
- if (Array.isArray(packageJson.keywords)) {
768
- const keywords = packageJson.keywords;
769
- const keywordMap = {
770
- "mcp-server": "mcp",
771
- "mcp": "mcp",
772
- "model-context-protocol": "mcp",
773
- "ccjk-skill": "skill",
774
- "claude-skill": "skill",
775
- "ccjk-agent": "agent",
776
- "ccjk-hook": "hook"
777
- };
778
- for (const keyword of keywords) {
779
- const type = keywordMap[keyword.toLowerCase()];
780
- if (type) {
781
- 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
+ }
782
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`);
783
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
+ };
784
951
  }
785
- if (packageJson.bin) {
786
- const binKeys = Object.keys(packageJson.bin);
787
- for (const key of binKeys) {
788
- if (key.includes("mcp") || key.includes("server")) {
789
- 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 });
790
982
  }
791
983
  }
792
- }
793
- if (typeof packageJson.main === "string") {
794
- const main = packageJson.main.toLowerCase();
795
- if (main.includes("server") || main.includes("mcp")) {
796
- 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 (!nodeFs.existsSync(fullPath))
987
+ continue;
988
+ const content = nodeFs.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
+ }
797
1016
  }
798
- }
799
- return { type: "skill", confidence: "low", reason: "No specific indicators" };
800
- }
801
-
802
- async function addCommand(source, options = {}) {
803
- const { force = false, dryRun = false, json = false, lang = "en" } = options;
804
- const i18n = getI18n(lang);
805
- const spinner = json ? null : ora(i18n.parsing).start();
806
- let sourceInfo;
807
- try {
808
- sourceInfo = parseSource(source);
809
- spinner?.succeed(i18n.parsed(sourceInfo.type));
810
- } catch (error) {
811
- spinner?.fail(i18n.parseFailed);
812
- const result = {
813
- success: false,
814
- source,
815
- sourceType: "local",
816
- pluginType: "skill",
817
- 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
818
1029
  };
819
- if (json) {
820
- console.log(JSON.stringify(result, null, 2));
821
- } else {
822
- console.error(ansis.red(`
823
- ${i18n.error}: ${result.error}
824
- `));
825
- }
826
- return result;
827
1030
  }
828
- let pluginType = options.type;
829
- if (!pluginType) {
830
- spinner?.start(i18n.detectingType);
1031
+ /**
1032
+ * 获取暂存的文件
1033
+ */
1034
+ getStagedFiles() {
831
1035
  try {
832
- pluginType = await detectPluginType(sourceInfo);
833
- 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);
834
1041
  } catch {
835
- spinner?.info(i18n.defaultType);
836
- pluginType = "skill";
1042
+ return [];
837
1043
  }
838
1044
  }
839
- spinner?.start(dryRun ? i18n.previewInstall : i18n.installing);
840
- try {
841
- let result;
842
- switch (sourceInfo.type) {
843
- case "github":
844
- result = await installFromGitHub(sourceInfo, pluginType, { force, dryRun });
845
- break;
846
- case "npm":
847
- result = await installFromNpm(sourceInfo, pluginType, { force, dryRun });
848
- break;
849
- case "local":
850
- result = await installFromLocal(sourceInfo, pluginType, { force, dryRun });
851
- break;
852
- default:
853
- throw new Error(`Unsupported source type: ${sourceInfo.type}`);
854
- }
855
- if (result.success) {
856
- spinner?.succeed(dryRun ? i18n.previewSuccess : i18n.installSuccess);
857
- } else {
858
- spinner?.fail(i18n.installFailed);
859
- }
860
- if (json) {
861
- console.log(JSON.stringify(result, null, 2));
862
- } else if (result.success && !dryRun) {
863
- printSuccessMessage(result, i18n);
864
- } else if (result.success && dryRun) {
865
- printPreviewMessage(result, i18n);
866
- } else {
867
- console.error(ansis.red(`
868
- ${i18n.error}: ${result.error}
869
- `));
1045
+ /**
1046
+ * 获取所有源文件
1047
+ */
1048
+ getAllSourceFiles() {
1049
+ const files = [];
1050
+ const walk = (dir) => {
1051
+ const entries = nodeFs.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);
870
1112
  }
871
- return result;
872
- } catch (error) {
873
- spinner?.fail(i18n.installFailed);
874
- const result = {
875
- success: false,
876
- source,
877
- sourceType: sourceInfo.type,
878
- pluginType,
879
- 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)
880
1122
  };
881
- if (json) {
882
- console.log(JSON.stringify(result, null, 2));
883
- } else {
884
- console.error(ansis.red(`
885
- ${i18n.error}: ${result.error}
886
- `));
1123
+ const summaryPath = path.join(this.postmortemDir, "summaries", `${version}.json`);
1124
+ nodeFs.writeFileSync(summaryPath, JSON.stringify(summary, null, 2), "utf-8");
1125
+ if (this.config.autoSyncToClaudeMd) {
1126
+ await this.syncToClaudeMd();
887
1127
  }
888
- return result;
1128
+ return summary;
889
1129
  }
890
- }
891
- function printSuccessMessage(result, i18n) {
892
- console.log();
893
- console.log(ansis.green.bold(`\u2713 ${i18n.installed}`));
894
- console.log();
895
- console.log(` ${ansis.gray(i18n.name)}: ${result.details?.name || result.source}`);
896
- if (result.details?.version) {
897
- console.log(` ${ansis.gray(i18n.version)}: ${result.details.version}`);
898
- }
899
- console.log(` ${ansis.gray(i18n.type)}: ${result.pluginType}`);
900
- console.log(` ${ansis.gray(i18n.path)}: ${result.installedPath}`);
901
- console.log();
902
- console.log(ansis.cyan(i18n.nextSteps));
903
- switch (result.pluginType) {
904
- case "skill":
905
- console.log(` ${ansis.gray("\u2022")} ${i18n.skillHint}`);
906
- break;
907
- case "mcp":
908
- console.log(` ${ansis.gray("\u2022")} ${i18n.mcpHint}`);
909
- break;
910
- case "agent":
911
- console.log(` ${ansis.gray("\u2022")} ${i18n.agentHint}`);
912
- break;
913
- case "hook":
914
- console.log(` ${ansis.gray("\u2022")} ${i18n.hookHint}`);
915
- break;
916
- }
917
- console.log();
918
- }
919
- function printPreviewMessage(result, i18n) {
920
- console.log();
921
- console.log(ansis.yellow.bold(`\u26A1 ${i18n.preview}`));
922
- console.log();
923
- console.log(` ${ansis.gray(i18n.source)}: ${result.source}`);
924
- console.log(` ${ansis.gray(i18n.type)}: ${result.pluginType}`);
925
- console.log(` ${ansis.gray(i18n.target)}: ${result.installedPath}`);
926
- if (result.details?.files?.length) {
927
- console.log(` ${ansis.gray(i18n.files)}:`);
928
- for (const file of result.details.files.slice(0, 5)) {
929
- console.log(` ${ansis.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
+ }
930
1147
  }
931
- if (result.details.files.length > 5) {
932
- console.log(` ${ansis.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
+ }
933
1159
  }
1160
+ return Array.from(lessons).slice(0, 10);
934
1161
  }
935
- console.log();
936
- console.log(ansis.gray(i18n.dryRunNote));
937
- console.log();
938
1162
  }
939
- function getI18n(lang) {
940
- const texts = {
941
- "zh-CN": {
942
- parsing: "\u89E3\u6790\u6765\u6E90...",
943
- parsed: (type) => `\u6765\u6E90\u7C7B\u578B: ${type}`,
944
- parseFailed: "\u89E3\u6790\u6765\u6E90\u5931\u8D25",
945
- detectingType: "\u68C0\u6D4B\u63D2\u4EF6\u7C7B\u578B...",
946
- detectedType: (type) => `\u68C0\u6D4B\u5230\u7C7B\u578B: ${type}`,
947
- defaultType: "\u4F7F\u7528\u9ED8\u8BA4\u7C7B\u578B: skill",
948
- installing: "\u5B89\u88C5\u4E2D...",
949
- previewInstall: "\u9884\u89C8\u5B89\u88C5...",
950
- installSuccess: "\u5B89\u88C5\u6210\u529F",
951
- previewSuccess: "\u9884\u89C8\u5B8C\u6210",
952
- installFailed: "\u5B89\u88C5\u5931\u8D25",
953
- error: "\u9519\u8BEF",
954
- installed: "\u63D2\u4EF6\u5DF2\u5B89\u88C5",
955
- preview: "\u5B89\u88C5\u9884\u89C8 (dry-run)",
956
- name: "\u540D\u79F0",
957
- version: "\u7248\u672C",
958
- type: "\u7C7B\u578B",
959
- path: "\u8DEF\u5F84",
960
- source: "\u6765\u6E90",
961
- target: "\u76EE\u6807",
962
- files: "\u6587\u4EF6",
963
- nextSteps: "\u4E0B\u4E00\u6B65:",
964
- skillHint: "\u4F7F\u7528 /skill-name \u5728 Claude Code \u4E2D\u8C03\u7528",
965
- mcpHint: "\u8FD0\u884C ccjk mcp status \u67E5\u770B\u72B6\u6001",
966
- agentHint: "\u4F7F\u7528 ccjk agent list \u67E5\u770B\u5DF2\u5B89\u88C5\u7684 agent",
967
- hookHint: "\u8FD0\u884C ccjk hooks list \u67E5\u770B\u5DF2\u5B89\u88C5\u7684 hook",
968
- dryRunNote: "\u8FD9\u662F\u9884\u89C8\u6A21\u5F0F\uFF0C\u672A\u5B9E\u9645\u5B89\u88C5\u3002\u79FB\u9664 --dry-run \u6267\u884C\u5B89\u88C5\u3002",
969
- andMore: (n) => `\u8FD8\u6709 ${n} \u4E2A\u6587\u4EF6`
970
- },
971
- "en": {
972
- parsing: "Parsing source...",
973
- parsed: (type) => `Source type: ${type}`,
974
- parseFailed: "Failed to parse source",
975
- detectingType: "Detecting plugin type...",
976
- detectedType: (type) => `Detected type: ${type}`,
977
- defaultType: "Using default type: skill",
978
- installing: "Installing...",
979
- previewInstall: "Previewing installation...",
980
- installSuccess: "Installation successful",
981
- previewSuccess: "Preview complete",
982
- installFailed: "Installation failed",
983
- error: "Error",
984
- installed: "Plugin installed",
985
- preview: "Installation preview (dry-run)",
986
- name: "Name",
987
- version: "Version",
988
- type: "Type",
989
- path: "Path",
990
- source: "Source",
991
- target: "Target",
992
- files: "Files",
993
- nextSteps: "Next steps:",
994
- skillHint: "Use /skill-name in Claude Code to invoke",
995
- mcpHint: "Run ccjk mcp status to check status",
996
- agentHint: "Use ccjk agent list to see installed agents",
997
- hookHint: "Run ccjk hooks list to see installed hooks",
998
- dryRunNote: "This is preview mode, nothing was installed. Remove --dry-run to install.",
999
- andMore: (n) => `and ${n} more files`
1000
- }
1001
- };
1002
- 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;
1003
1169
  }
1004
1170
 
1005
- export { addCommand, parseSource };
1171
+ export { PostmortemAnalyzer, PostmortemManager, getPostmortemManager };