ccjk 9.5.6 → 9.7.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 (103) hide show
  1. package/dist/chunks/agent.mjs +1 -1
  2. package/dist/chunks/api-providers.mjs +1 -1
  3. package/dist/chunks/api.mjs +3 -3
  4. package/dist/chunks/auto-bootstrap.mjs +1 -1
  5. package/dist/chunks/auto-updater.mjs +1 -1
  6. package/dist/chunks/boost.mjs +160 -0
  7. package/dist/chunks/ccjk-agents.mjs +1 -1
  8. package/dist/chunks/ccjk-all.mjs +1 -1
  9. package/dist/chunks/ccjk-config.mjs +1 -1
  10. package/dist/chunks/ccjk-hooks.mjs +1 -1
  11. package/dist/chunks/ccjk-mcp.mjs +2 -2
  12. package/dist/chunks/ccjk-setup.mjs +1 -1
  13. package/dist/chunks/ccjk-skills.mjs +1 -1
  14. package/dist/chunks/ccr.mjs +25 -30
  15. package/dist/chunks/ccu.mjs +1 -1
  16. package/dist/chunks/check-updates.mjs +3 -4
  17. package/dist/chunks/claude-code-config-manager.mjs +7 -7
  18. package/dist/chunks/claude-code-incremental-manager.mjs +2 -2
  19. package/dist/chunks/claude-config.mjs +4 -4
  20. package/dist/chunks/claude-wrapper.mjs +2 -2
  21. package/dist/chunks/codex-config-switch.mjs +4 -5
  22. package/dist/chunks/codex-provider-manager.mjs +2 -3
  23. package/dist/chunks/codex-uninstaller.mjs +2 -2
  24. package/dist/chunks/codex.mjs +207 -6
  25. package/dist/chunks/commands.mjs +391 -88
  26. package/dist/chunks/commands2.mjs +88 -391
  27. package/dist/chunks/completion.mjs +1 -1
  28. package/dist/chunks/config-consolidator.mjs +2 -2
  29. package/dist/chunks/config-switch.mjs +3 -4
  30. package/dist/chunks/config.mjs +78 -7
  31. package/dist/chunks/config2.mjs +400 -410
  32. package/dist/chunks/config3.mjs +410 -400
  33. package/dist/chunks/constants.mjs +1 -1
  34. package/dist/chunks/doctor.mjs +4 -4
  35. package/dist/chunks/features.mjs +24 -17
  36. package/dist/chunks/index.mjs +178 -7
  37. package/dist/chunks/index2.mjs +1162 -169
  38. package/dist/chunks/index3.mjs +910 -1076
  39. package/dist/chunks/index4.mjs +137 -947
  40. package/dist/chunks/index5.mjs +635 -167
  41. package/dist/chunks/init.mjs +141 -99
  42. package/dist/chunks/installer.mjs +147 -649
  43. package/dist/chunks/installer2.mjs +649 -147
  44. package/dist/chunks/interview.mjs +2 -2
  45. package/dist/chunks/marketplace.mjs +1 -1
  46. package/dist/chunks/mcp.mjs +1058 -17
  47. package/dist/chunks/menu.mjs +147 -56
  48. package/dist/chunks/monitor.mjs +2 -2
  49. package/dist/chunks/notification.mjs +1 -1
  50. package/dist/chunks/onboarding.mjs +2 -2
  51. package/dist/chunks/package.mjs +2 -210
  52. package/dist/chunks/permission-manager.mjs +2 -2
  53. package/dist/chunks/permissions.mjs +1 -1
  54. package/dist/chunks/platform.mjs +1 -1
  55. package/dist/chunks/plugin.mjs +1 -1
  56. package/dist/chunks/prompts.mjs +1 -1
  57. package/dist/chunks/providers.mjs +1 -1
  58. package/dist/chunks/quick-setup.mjs +16 -20
  59. package/dist/chunks/silent-updater.mjs +1 -1
  60. package/dist/chunks/simple-config.mjs +2 -2
  61. package/dist/chunks/skill.mjs +1 -1
  62. package/dist/chunks/skills-sync.mjs +1 -1
  63. package/dist/chunks/skills.mjs +1 -1
  64. package/dist/chunks/startup.mjs +1 -1
  65. package/dist/chunks/stats.mjs +1 -1
  66. package/dist/chunks/status.mjs +159 -0
  67. package/dist/chunks/team.mjs +1 -1
  68. package/dist/chunks/thinking.mjs +2 -2
  69. package/dist/chunks/uninstall.mjs +6 -6
  70. package/dist/chunks/update.mjs +6 -9
  71. package/dist/chunks/upgrade-manager.mjs +2 -2
  72. package/dist/chunks/version-checker.mjs +3 -3
  73. package/dist/chunks/vim.mjs +1 -1
  74. package/dist/chunks/workflows.mjs +616 -215
  75. package/dist/cli.mjs +70 -121
  76. package/dist/index.d.mts +17 -1482
  77. package/dist/index.d.ts +17 -1482
  78. package/dist/index.mjs +950 -4740
  79. package/dist/shared/{ccjk.zCqdxT2Y.mjs → ccjk.Br91zBIG.mjs} +2 -2
  80. package/dist/shared/ccjk.CSkyCZIM.mjs +638 -0
  81. package/dist/shared/{ccjk.BKoi8-Hy.mjs → ccjk.DE91nClQ.mjs} +1 -1
  82. package/dist/shared/{ccjk.f40us0yY.mjs → ccjk.DvIrK0wz.mjs} +2 -2
  83. package/dist/shared/ccjk.LsPZ2PYo.mjs +1048 -0
  84. package/dist/shared/{ccjk.DRweXU5F.mjs → ccjk.q1koQxEE.mjs} +2 -2
  85. package/package.json +1 -1
  86. package/templates/claude-code/common/settings.json +15 -111
  87. package/dist/chunks/api-adapter.mjs +0 -180
  88. package/dist/chunks/cli.mjs +0 -2227
  89. package/dist/chunks/context-menu.mjs +0 -913
  90. package/dist/chunks/hooks-sync.mjs +0 -1627
  91. package/dist/chunks/index6.mjs +0 -663
  92. package/dist/chunks/mcp-market.mjs +0 -1077
  93. package/dist/chunks/mcp-server.mjs +0 -776
  94. package/dist/chunks/project-detector.mjs +0 -131
  95. package/dist/chunks/provider-registry.mjs +0 -92
  96. package/dist/chunks/setup-wizard.mjs +0 -362
  97. package/dist/chunks/tools.mjs +0 -143
  98. package/dist/chunks/workflows2.mjs +0 -633
  99. package/dist/shared/ccjk.BM_HZogn.mjs +0 -347
  100. package/dist/shared/ccjk.BaEp4UHQ.mjs +0 -75
  101. package/dist/shared/ccjk.CS0ybJCf.mjs +0 -490
  102. package/dist/shared/ccjk.CZgIwikC.mjs +0 -209
  103. package/dist/shared/ccjk.tO8zeFh1.mjs +0 -397
@@ -1,1171 +1,1005 @@
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';
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';
5
8
 
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 [];
9
+ function getCcjkConfigDir() {
10
+ if (process.env.CCJK_CONFIG_DIR) {
11
+ return process.env.CCJK_CONFIG_DIR;
18
12
  }
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);
19
24
  }
20
- function parseGitLog(output) {
21
- const commits = [];
22
- const entries = output.trim().split("\n\n");
25
+ async function copyDirectory(src, dest) {
26
+ await fs.mkdir(dest, { recursive: true });
27
+ const entries = await fs.readdir(src, { withFileTypes: true });
23
28
  for (const entry of entries) {
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
- });
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);
42
35
  }
43
36
  }
44
- return commits;
45
- }
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));
62
37
  }
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
- };
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);
79
50
  }
80
- function getCommitDiff(hash, cwd) {
51
+
52
+ async function installFromGitHub(sourceInfo, pluginType, options = {}) {
53
+ const { force = false, dryRun = false } = options;
54
+ const { owner, repo, ref = "main", subpath } = sourceInfo;
81
55
  try {
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 "";
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
+ };
90
116
  }
91
117
  }
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
- ]
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"
164
124
  }
165
- ];
166
- for (const { category, patterns: categoryPatterns } of patterns) {
167
- if (categoryPatterns.some((p) => p.test(content))) {
168
- return category;
125
+ });
126
+ if (!response.ok) {
127
+ if (response.status === 404) {
128
+ throw new Error(`Repository not found: ${owner}/${repo}`);
169
129
  }
130
+ throw new Error(`Failed to fetch repository info: ${response.statusText}`);
170
131
  }
171
- return "other";
132
+ return response.json();
172
133
  }
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";
178
- }
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";
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 [];
184
145
  }
185
- return "low";
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;
186
149
  }
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();
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;
159
+ }
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.");
200
171
  }
201
172
  }
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`;
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");
206
177
  }
207
- return "\u9700\u8981\u8FDB\u4E00\u6B65\u5206\u6790";
178
+ return path__default.join(destDir, extractedDir);
208
179
  }
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");
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
+ }
216
192
  }
217
- return `\u65B0\u589E ${addedLines.length} \u884C\u4EE3\u7801\u4FEE\u590D\u95EE\u9898`;
193
+ await walk(dir);
194
+ return files;
218
195
  }
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"
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
323
242
  }
324
243
  };
325
- reports.push(report);
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
+ }
326
298
  }
327
299
  }
328
- return reports;
300
+ await walk(dir);
301
+ return files;
329
302
  }
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] = [];
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 {
336
329
  }
337
- grouped[category].push(analysis);
338
330
  }
339
- return grouped;
331
+ return {};
340
332
  }
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]));
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);
350
374
  } else {
351
- merged.push({ ...analysis });
375
+ await installGenericPackage(packageName, packageVersion, installPath);
352
376
  }
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
+ };
353
399
  }
354
- return merged;
355
- }
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;
362
400
  }
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;
366
- }
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"
380
- };
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}`;
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}`);
386
409
  }
387
- return baseTitle;
410
+ const data = await response.json();
411
+ return {
412
+ version: data.version,
413
+ description: data.description,
414
+ files: data.files
415
+ };
388
416
  }
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();
417
+ function getShortName(packageName) {
418
+ if (packageName.startsWith("@")) {
419
+ const parts = packageName.split("/");
420
+ return parts[1] || packageName;
421
+ }
422
+ return packageName;
400
423
  }
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`);
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
463
432
  }
464
- if (file.includes("config")) {
465
- directives.push(`\u4FEE\u6539\u914D\u7F6E\u6587\u4EF6\u65F6\u786E\u4FDD\u5411\u540E\u517C\u5BB9`);
433
+ };
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
+ );
466
447
  }
467
448
  }
468
- return Array.from(new Set(directives));
469
449
  }
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"
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
+ }
475
+ }
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
+ }
542
490
  }
543
- ],
544
- "other": []
545
- };
546
- patterns.push(...categoryPatterns[analysis.bugType] || []);
547
- return patterns;
491
+ } catch {
492
+ }
493
+ }
494
+ await walk(dir);
495
+ return files;
548
496
  }
549
- const PostmortemAnalyzer = {
550
- getFixCommits,
551
- analyzeFixCommit,
552
- generatePostmortem
553
- };
554
497
 
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"
498
+ function parseSource(source) {
499
+ const trimmed = source.trim();
500
+ const githubInfo = parseGitHubSource(trimmed);
501
+ if (githubInfo) {
502
+ return githubInfo;
568
503
  }
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);
504
+ const localInfo = parseLocalSource(trimmed);
505
+ if (localInfo) {
506
+ return localInfo;
581
507
  }
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 };
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
+ };
610
520
  }
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
- }
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
+ };
625
533
  }
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;
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
+ };
640
543
  }
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;
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);
654
555
  }
556
+ return {
557
+ type: "local",
558
+ absolutePath,
559
+ originalPath: source
560
+ };
655
561
  }
656
- /**
657
- * 列出所有 Postmortem
658
- */
659
- listReports() {
660
- const index = this.loadIndex();
661
- return index?.reports || [];
662
- }
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}"
562
+ if (/^[a-z]:[\\/]/i.test(source)) {
563
+ return {
564
+ type: "local",
565
+ absolutePath: path__default.resolve(source),
566
+ originalPath: source
672
567
  };
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
568
  }
740
- /**
741
- * 生成 slug
742
- */
743
- slugify(text) {
744
- return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").substring(0, 50);
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]
581
+ };
745
582
  }
746
- // ==========================================================================
747
- // Index Management
748
- // ==========================================================================
749
- /**
750
- * 创建空索引
751
- */
752
- createEmptyIndex() {
583
+ const versionMatch = packageStr.match(/^([^@]+)@(.+)$/);
584
+ if (versionMatch) {
753
585
  return {
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: []
586
+ type: "npm",
587
+ packageName: versionMatch[1],
588
+ version: versionMatch[2]
775
589
  };
776
590
  }
777
- /**
778
- * 加载索引
779
- */
780
- loadIndex() {
781
- const indexPath = path.join(this.postmortemDir, INDEX_FILE);
782
- if (!fs.existsSync(indexPath)) {
783
- return null;
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
+ }
784
631
  }
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) {
785
643
  try {
786
- const content = fs.readFileSync(indexPath, "utf-8");
787
- return JSON.parse(content);
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
+ }
788
653
  } catch {
789
- return null;
790
654
  }
791
655
  }
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");
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;
798
662
  }
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 {
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
+ }
823
675
  }
824
676
  }
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;
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;
835
687
  }
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");
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;
848
695
  }
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);
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 {
853
716
  }
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
- };
868
717
  }
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
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"
881
725
  };
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
- }
893
- }
894
726
  }
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
- }
936
- }
937
- for (const d of allDirectives) {
938
- lines.push(`- ${d}`);
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" };
939
764
  }
940
- lines.push("");
941
- lines.push(`> \u8BE6\u7EC6\u4FE1\u606F\u8BF7\u67E5\u770B \`${this.config.directory}/\` \u76EE\u5F55`);
942
765
  }
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
- };
951
766
  }
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 });
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}` };
982
782
  }
983
783
  }
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
- }
784
+ }
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}` };
1015
790
  }
1016
791
  }
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
1029
- };
1030
792
  }
1031
- /**
1032
- * 获取暂存的文件
1033
- */
1034
- getStagedFiles() {
1035
- try {
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);
1041
- } catch {
1042
- return [];
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}` };
1043
797
  }
1044
798
  }
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
- }
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)
1066
818
  };
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);
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;
1076
827
  }
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
- };
828
+ let pluginType = options.type;
829
+ if (!pluginType) {
830
+ spinner?.start(i18n.detectingType);
831
+ try {
832
+ pluginType = await detectPluginType(sourceInfo);
833
+ spinner?.succeed(i18n.detectedType(pluginType));
834
+ } catch {
835
+ spinner?.info(i18n.defaultType);
836
+ pluginType = "skill";
837
+ }
1088
838
  }
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);
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}`);
1112
854
  }
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)
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
+ `));
870
+ }
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)
1122
880
  };
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();
881
+ if (json) {
882
+ console.log(JSON.stringify(result, null, 2));
883
+ } else {
884
+ console.error(ansis.red(`
885
+ ${i18n.error}: ${result.error}
886
+ `));
1127
887
  }
1128
- return summary;
888
+ return result;
1129
889
  }
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
- }
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}`);
1147
930
  }
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
- }
931
+ if (result.details.files.length > 5) {
932
+ console.log(` ${ansis.gray("...")} ${i18n.andMore(result.details.files.length - 5)}`);
1159
933
  }
1160
- return Array.from(lessons).slice(0, 10);
1161
934
  }
935
+ console.log();
936
+ console.log(ansis.gray(i18n.dryRunNote));
937
+ console.log();
1162
938
  }
1163
- let managerInstance = null;
1164
- function getPostmortemManager(projectRoot, config) {
1165
- if (!managerInstance || projectRoot) {
1166
- managerInstance = new PostmortemManager(projectRoot, config);
1167
- }
1168
- return managerInstance;
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];
1169
1003
  }
1170
1004
 
1171
- export { PostmortemAnalyzer, PostmortemManager, getPostmortemManager };
1005
+ export { addCommand, parseSource };