port-doctor-cli 1.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.
- package/LICENSE +21 -0
- package/README.md +266 -0
- package/bin/port-doctor.js +8 -0
- package/dist/cli/commands/free.d.ts +3 -0
- package/dist/cli/commands/free.d.ts.map +1 -0
- package/dist/cli/commands/free.js +120 -0
- package/dist/cli/commands/free.js.map +1 -0
- package/dist/cli/commands/overview.d.ts +3 -0
- package/dist/cli/commands/overview.d.ts.map +1 -0
- package/dist/cli/commands/overview.js +19 -0
- package/dist/cli/commands/overview.js.map +1 -0
- package/dist/cli/commands/run.d.ts +4 -0
- package/dist/cli/commands/run.d.ts.map +1 -0
- package/dist/cli/commands/run.js +133 -0
- package/dist/cli/commands/run.js.map +1 -0
- package/dist/cli/commands/why.d.ts +3 -0
- package/dist/cli/commands/why.d.ts.map +1 -0
- package/dist/cli/commands/why.js +24 -0
- package/dist/cli/commands/why.js.map +1 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +200 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/output/formatter.d.ts +6 -0
- package/dist/cli/output/formatter.d.ts.map +1 -0
- package/dist/cli/output/formatter.js +177 -0
- package/dist/cli/output/formatter.js.map +1 -0
- package/dist/cli/output/json.d.ts +2 -0
- package/dist/cli/output/json.d.ts.map +1 -0
- package/dist/cli/output/json.js +6 -0
- package/dist/cli/output/json.js.map +1 -0
- package/dist/cli/output/tree.d.ts +3 -0
- package/dist/cli/output/tree.d.ts.map +1 -0
- package/dist/cli/output/tree.js +19 -0
- package/dist/cli/output/tree.js.map +1 -0
- package/dist/cli/prompts/confirm.d.ts +3 -0
- package/dist/cli/prompts/confirm.d.ts.map +1 -0
- package/dist/cli/prompts/confirm.js +53 -0
- package/dist/cli/prompts/confirm.js.map +1 -0
- package/dist/core/diagnosis/index.d.ts +4 -0
- package/dist/core/diagnosis/index.d.ts.map +1 -0
- package/dist/core/diagnosis/index.js +109 -0
- package/dist/core/diagnosis/index.js.map +1 -0
- package/dist/core/framework/index.d.ts +5 -0
- package/dist/core/framework/index.d.ts.map +1 -0
- package/dist/core/framework/index.js +211 -0
- package/dist/core/framework/index.js.map +1 -0
- package/dist/core/git/index.d.ts +3 -0
- package/dist/core/git/index.d.ts.map +1 -0
- package/dist/core/git/index.js +56 -0
- package/dist/core/git/index.js.map +1 -0
- package/dist/core/lifecycle/index.d.ts +8 -0
- package/dist/core/lifecycle/index.d.ts.map +1 -0
- package/dist/core/lifecycle/index.js +175 -0
- package/dist/core/lifecycle/index.js.map +1 -0
- package/dist/core/process/index.d.ts +9 -0
- package/dist/core/process/index.d.ts.map +1 -0
- package/dist/core/process/index.js +94 -0
- package/dist/core/process/index.js.map +1 -0
- package/dist/core/project/index.d.ts +3 -0
- package/dist/core/project/index.d.ts.map +1 -0
- package/dist/core/project/index.js +84 -0
- package/dist/core/project/index.js.map +1 -0
- package/dist/core/scanner/index.d.ts +5 -0
- package/dist/core/scanner/index.d.ts.map +1 -0
- package/dist/core/scanner/index.js +71 -0
- package/dist/core/scanner/index.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/platform/darwin.d.ts +27 -0
- package/dist/platform/darwin.d.ts.map +1 -0
- package/dist/platform/darwin.js +268 -0
- package/dist/platform/darwin.js.map +1 -0
- package/dist/platform/index.d.ts +4 -0
- package/dist/platform/index.d.ts.map +1 -0
- package/dist/platform/index.js +26 -0
- package/dist/platform/index.js.map +1 -0
- package/dist/platform/linux.d.ts +22 -0
- package/dist/platform/linux.d.ts.map +1 -0
- package/dist/platform/linux.js +217 -0
- package/dist/platform/linux.js.map +1 -0
- package/dist/platform/types.d.ts +40 -0
- package/dist/platform/types.d.ts.map +1 -0
- package/dist/platform/types.js +2 -0
- package/dist/platform/types.js.map +1 -0
- package/dist/platform/windows.d.ts +17 -0
- package/dist/platform/windows.d.ts.map +1 -0
- package/dist/platform/windows.js +138 -0
- package/dist/platform/windows.js.map +1 -0
- package/dist/types/index.d.ts +101 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +2 -0
- package/dist/types/index.js.map +1 -0
- package/dist/utils/exec.d.ts +16 -0
- package/dist/utils/exec.d.ts.map +1 -0
- package/dist/utils/exec.js +51 -0
- package/dist/utils/exec.js.map +1 -0
- package/dist/utils/formatting.d.ts +10 -0
- package/dist/utils/formatting.d.ts.map +1 -0
- package/dist/utils/formatting.js +60 -0
- package/dist/utils/formatting.js.map +1 -0
- package/dist/utils/redaction.d.ts +5 -0
- package/dist/utils/redaction.d.ts.map +1 -0
- package/dist/utils/redaction.js +31 -0
- package/dist/utils/redaction.js.map +1 -0
- package/package.json +56 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { isSystemProcess } from '../framework/index.js';
|
|
2
|
+
export function isOrphanDevProcess(process, framework) {
|
|
3
|
+
if (!process || process.ppid !== 1)
|
|
4
|
+
return false;
|
|
5
|
+
// Never classify databases or system daemons as orphans
|
|
6
|
+
if (framework?.category === 'database' || framework?.category === 'system' || isSystemProcess(process)) {
|
|
7
|
+
return false;
|
|
8
|
+
}
|
|
9
|
+
if (process.user === 'root') {
|
|
10
|
+
return false;
|
|
11
|
+
}
|
|
12
|
+
const name = (process.name || '').toLowerCase();
|
|
13
|
+
const cmd = (process.fullCommand || process.command || '').toLowerCase();
|
|
14
|
+
// Known infrastructure / system daemons that shouldn't be called dev orphans
|
|
15
|
+
const isDaemon = [
|
|
16
|
+
'redis', 'postgres', 'postmaster', 'mongod', 'mysqld', 'mariadbd',
|
|
17
|
+
'nginx', 'caddy', 'docker', 'dockerd', 'docker-proxy', 'containerd',
|
|
18
|
+
'sshd', 'systemd', 'launchd', 'cupsd', 'mdnsresponder', 'controlcenter', 'controlce'
|
|
19
|
+
].some((d) => name.includes(d) || cmd.includes(d));
|
|
20
|
+
if (isDaemon)
|
|
21
|
+
return false;
|
|
22
|
+
// Only consider standard interactive dev tools/runtimes
|
|
23
|
+
const isDevRuntime = [
|
|
24
|
+
'node', 'bun', 'deno', 'vite', 'next', 'astro', 'webpack',
|
|
25
|
+
'python', 'python3', 'uvicorn', 'gunicorn', 'flask',
|
|
26
|
+
'ruby', 'puma', 'rails', 'cargo', 'go'
|
|
27
|
+
].some((r) => name === r || name.startsWith(r) || cmd.includes(r));
|
|
28
|
+
return isDevRuntime;
|
|
29
|
+
}
|
|
30
|
+
export function diagnosePort(info) {
|
|
31
|
+
if (info.status === 'free') {
|
|
32
|
+
return {
|
|
33
|
+
type: 'free',
|
|
34
|
+
severity: 'info',
|
|
35
|
+
summary: `Port ${info.port} is free and ready for use.`,
|
|
36
|
+
safeToFree: false,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
const framework = info.framework?.name || 'Unknown process';
|
|
40
|
+
const project = info.project?.name || 'an unknown project';
|
|
41
|
+
const branch = info.git?.branch ? ` on branch '${info.git.branch}'` : '';
|
|
42
|
+
const isOrphan = info.process?.isOrphan ?? isOrphanDevProcess(info.process, info.framework);
|
|
43
|
+
const isDb = info.framework?.category === 'database';
|
|
44
|
+
const isSystem = !isDb && (info.framework?.category === 'system' || isSystemProcess(info.process) || (info.process?.user === 'root' && !isDb));
|
|
45
|
+
if (isDb) {
|
|
46
|
+
return {
|
|
47
|
+
type: 'database',
|
|
48
|
+
severity: 'info',
|
|
49
|
+
summary: `Port ${info.port} is occupied by ${framework} database.`,
|
|
50
|
+
details: [
|
|
51
|
+
`Service: ${framework}`,
|
|
52
|
+
`PID: ${info.pid}`,
|
|
53
|
+
`Notice: Terminating a database instance may cause data loss in active transactions.`,
|
|
54
|
+
],
|
|
55
|
+
suggestedAction: `If this database was started by another project, verify before stopping, or configure your current project to connect to it.`,
|
|
56
|
+
safeToFree: false,
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
if (isSystem) {
|
|
60
|
+
const serviceName = info.framework?.name || info.process?.name || 'System service';
|
|
61
|
+
let suggestedAction = `Port ${info.port} is used by the ${serviceName} system service.`;
|
|
62
|
+
const procNameLower = (info.process?.name || '').toLowerCase();
|
|
63
|
+
const exeLower = (info.process?.executablePath || '').toLowerCase();
|
|
64
|
+
if ((procNameLower.includes('controlce') || procNameLower.includes('controlcenter') || exeLower.includes('controlcenter')) &&
|
|
65
|
+
info.port === 5000) {
|
|
66
|
+
suggestedAction = `Port 5000 is used by the macOS ControlCenter system service (AirPlay Receiver). To free port 5000 on macOS Monterey or later, disable 'AirPlay Receiver' in System Settings > General > AirDrop & AirPlay.`;
|
|
67
|
+
}
|
|
68
|
+
return {
|
|
69
|
+
type: 'system_service',
|
|
70
|
+
severity: 'warning',
|
|
71
|
+
summary: `Port ${info.port} is occupied by ${serviceName}.`,
|
|
72
|
+
details: [
|
|
73
|
+
`Service: ${serviceName}`,
|
|
74
|
+
`PID: ${info.pid}`,
|
|
75
|
+
`Executable: ${info.process?.executablePath || info.process?.fullCommand || 'unknown'}`,
|
|
76
|
+
`Notice: This is an operating system service. Terminating it is not recommended.`,
|
|
77
|
+
],
|
|
78
|
+
suggestedAction,
|
|
79
|
+
safeToFree: false,
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
if (isOrphan) {
|
|
83
|
+
return {
|
|
84
|
+
type: 'orphan_process',
|
|
85
|
+
severity: 'warning',
|
|
86
|
+
summary: `Port ${info.port} is occupied by an orphaned ${framework} process from ${project}.`,
|
|
87
|
+
details: [
|
|
88
|
+
`Project: ${project}${branch}`,
|
|
89
|
+
`PID: ${info.pid}`,
|
|
90
|
+
`The parent terminal/editor that started this process has already closed.`,
|
|
91
|
+
],
|
|
92
|
+
suggestedAction: `Run 'port-doctor free ${info.port}' to safely reclaim this port.`,
|
|
93
|
+
safeToFree: true,
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
return {
|
|
97
|
+
type: 'dev_server',
|
|
98
|
+
severity: 'warning',
|
|
99
|
+
summary: `Port ${info.port} is occupied by ${framework} (${project}${branch}).`,
|
|
100
|
+
details: [
|
|
101
|
+
`Command: ${info.process?.command || 'unknown'}`,
|
|
102
|
+
`Working Directory: ${info.project?.rootDirectory || info.process?.cwd || 'unknown'}`,
|
|
103
|
+
`Uptime: ${info.process?.uptimeFormatted || 'unknown'}`,
|
|
104
|
+
],
|
|
105
|
+
suggestedAction: `Run 'port-doctor free ${info.port}' to safely release the port, or stop the dev server in ${info.project?.rootDirectory || 'the terminal'}.`,
|
|
106
|
+
safeToFree: true,
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/diagnosis/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { FrameworkInfo, ProcessInfo, ProjectContext } from '../../types/index.js';
|
|
2
|
+
export declare function isSystemProcess(processInfo?: ProcessInfo): boolean;
|
|
3
|
+
export declare function formatSystemProcessName(name: string, exePath?: string): string;
|
|
4
|
+
export declare function detectFramework(processInfo?: ProcessInfo, projectContext?: ProjectContext, port?: number): Promise<FrameworkInfo | undefined>;
|
|
5
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/framework/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAElF,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAyDlE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC9E;AAED,wBAAsB,eAAe,CACnC,WAAW,CAAC,EAAE,WAAW,EACzB,cAAc,CAAC,EAAE,cAAc,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA4IpC"}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import * as fs from 'node:fs/promises';
|
|
2
|
+
export function isSystemProcess(processInfo) {
|
|
3
|
+
if (!processInfo)
|
|
4
|
+
return false;
|
|
5
|
+
const name = (processInfo.name || '').toLowerCase();
|
|
6
|
+
const exe = (processInfo.executablePath || '').toLowerCase();
|
|
7
|
+
const cmd = (processInfo.fullCommand || processInfo.command || '').toLowerCase();
|
|
8
|
+
// 1. Explicitly protect developer runtimes and databases from being misclassified
|
|
9
|
+
const isDevRuntime = ['node', 'bun', 'deno', 'python', 'python3', 'ruby', 'go', 'cargo', 'java', 'php'].some((r) => name === r || name.startsWith(r + '.') || name.startsWith(r + '_'));
|
|
10
|
+
if (isDevRuntime)
|
|
11
|
+
return false;
|
|
12
|
+
const isDatabase = ['redis', 'postgres', 'postmaster', 'mongod', 'mysqld', 'mariadbd'].some((db) => name.includes(db));
|
|
13
|
+
if (isDatabase)
|
|
14
|
+
return false;
|
|
15
|
+
// 2. macOS System Executable Paths
|
|
16
|
+
if (exe.startsWith('/system/library/') ||
|
|
17
|
+
exe.startsWith('/system/applications/') ||
|
|
18
|
+
exe.startsWith('/usr/libexec/') ||
|
|
19
|
+
exe.startsWith('/system/iosdevicesupport/') ||
|
|
20
|
+
cmd.startsWith('/system/library/') ||
|
|
21
|
+
cmd.startsWith('/usr/libexec/')) {
|
|
22
|
+
return true;
|
|
23
|
+
}
|
|
24
|
+
// 3. Windows System Executable Paths
|
|
25
|
+
if (exe.includes('\\windows\\system32\\') ||
|
|
26
|
+
exe.includes('\\windows\\syswow64\\') ||
|
|
27
|
+
cmd.includes('\\windows\\system32\\')) {
|
|
28
|
+
return true;
|
|
29
|
+
}
|
|
30
|
+
// 4. Linux System Service Paths
|
|
31
|
+
if (exe.startsWith('/usr/lib/systemd/') ||
|
|
32
|
+
exe.startsWith('/lib/systemd/') ||
|
|
33
|
+
cmd.startsWith('/usr/lib/systemd/')) {
|
|
34
|
+
return true;
|
|
35
|
+
}
|
|
36
|
+
// 5. Known OS System Daemons & Services by name
|
|
37
|
+
const systemDaemons = [
|
|
38
|
+
'controlcenter', 'controlce', 'mdnsresponder', 'rapportd', 'sharingd',
|
|
39
|
+
'launchd', 'cupsd', 'bluetoothd', 'coreaudiod', 'systemd', 'systemd-resolved',
|
|
40
|
+
'avahi-daemon', 'svchost', 'services.exe', 'lsass.exe', 'spoolsv.exe'
|
|
41
|
+
];
|
|
42
|
+
if (systemDaemons.includes(name) || systemDaemons.includes(name.replace(/\.exe$/, ''))) {
|
|
43
|
+
return true;
|
|
44
|
+
}
|
|
45
|
+
return false;
|
|
46
|
+
}
|
|
47
|
+
export function formatSystemProcessName(name, exePath) {
|
|
48
|
+
const lower = name.toLowerCase();
|
|
49
|
+
const exeLower = (exePath || '').toLowerCase();
|
|
50
|
+
if (lower.includes('controlce') || lower.includes('controlcenter') || exeLower.includes('controlcenter')) {
|
|
51
|
+
return 'macOS ControlCenter';
|
|
52
|
+
}
|
|
53
|
+
if (lower.includes('mdnsresponder') || exeLower.includes('mdnsresponder')) {
|
|
54
|
+
return 'macOS mDNSResponder (Bonjour)';
|
|
55
|
+
}
|
|
56
|
+
if (lower.includes('rapportd')) {
|
|
57
|
+
return 'macOS rapportd';
|
|
58
|
+
}
|
|
59
|
+
if (lower.includes('sharingd')) {
|
|
60
|
+
return 'macOS sharingd';
|
|
61
|
+
}
|
|
62
|
+
if (lower.includes('launchd')) {
|
|
63
|
+
return 'macOS launchd';
|
|
64
|
+
}
|
|
65
|
+
if (lower.includes('cupsd')) {
|
|
66
|
+
return 'CUPS Print Daemon';
|
|
67
|
+
}
|
|
68
|
+
if (lower.includes('systemd-resolved')) {
|
|
69
|
+
return 'systemd-resolved';
|
|
70
|
+
}
|
|
71
|
+
if (lower.includes('systemd')) {
|
|
72
|
+
return 'systemd';
|
|
73
|
+
}
|
|
74
|
+
if (lower.includes('svchost')) {
|
|
75
|
+
return 'Windows Service Host (svchost)';
|
|
76
|
+
}
|
|
77
|
+
return name || 'System Service';
|
|
78
|
+
}
|
|
79
|
+
export async function detectFramework(processInfo, projectContext, port) {
|
|
80
|
+
const cmd = (processInfo?.fullCommand || processInfo?.command || '').toLowerCase();
|
|
81
|
+
const procName = (processInfo?.name || '').toLowerCase();
|
|
82
|
+
// 1. Check known system processes
|
|
83
|
+
if (isSystemProcess(processInfo)) {
|
|
84
|
+
return {
|
|
85
|
+
name: formatSystemProcessName(processInfo?.name || 'System Service', processInfo?.executablePath),
|
|
86
|
+
category: 'system',
|
|
87
|
+
confidence: 'high',
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
// 2. Check known database and infrastructure daemons by process name / command
|
|
91
|
+
if (procName.includes('redis') || cmd.includes('redis-server')) {
|
|
92
|
+
return { name: 'Redis', category: 'database', confidence: 'high', defaultPort: 6379 };
|
|
93
|
+
}
|
|
94
|
+
if (procName.includes('postgres') || procName.includes('postmaster') || cmd.includes('postgres')) {
|
|
95
|
+
return { name: 'PostgreSQL', category: 'database', confidence: 'high', defaultPort: 5432 };
|
|
96
|
+
}
|
|
97
|
+
if (procName.includes('mongod') || cmd.includes('mongod')) {
|
|
98
|
+
return { name: 'MongoDB', category: 'database', confidence: 'high', defaultPort: 27017 };
|
|
99
|
+
}
|
|
100
|
+
if (procName.includes('mysqld') || procName.includes('mariadbd') || cmd.includes('mysqld')) {
|
|
101
|
+
return { name: 'MySQL', category: 'database', confidence: 'high', defaultPort: 3306 };
|
|
102
|
+
}
|
|
103
|
+
if (procName.includes('docker-proxy') || cmd.includes('docker-proxy')) {
|
|
104
|
+
return { name: 'Docker Container', category: 'tool', confidence: 'high' };
|
|
105
|
+
}
|
|
106
|
+
if (procName.includes('nginx')) {
|
|
107
|
+
return { name: 'Nginx', category: 'system', confidence: 'high', defaultPort: 80 };
|
|
108
|
+
}
|
|
109
|
+
if (procName.includes('caddy')) {
|
|
110
|
+
return { name: 'Caddy', category: 'system', confidence: 'high' };
|
|
111
|
+
}
|
|
112
|
+
// 2. Check Python web frameworks
|
|
113
|
+
if (cmd.includes('uvicorn') || cmd.includes('fastapi')) {
|
|
114
|
+
return { name: 'FastAPI (Uvicorn)', category: 'web-framework', confidence: 'high' };
|
|
115
|
+
}
|
|
116
|
+
if (cmd.includes('flask')) {
|
|
117
|
+
return { name: 'Flask', category: 'web-framework', confidence: 'high', defaultPort: 5000 };
|
|
118
|
+
}
|
|
119
|
+
if (cmd.includes('manage.py runserver') || cmd.includes('django')) {
|
|
120
|
+
return { name: 'Django', category: 'web-framework', confidence: 'high', defaultPort: 8000 };
|
|
121
|
+
}
|
|
122
|
+
if (cmd.includes('gunicorn')) {
|
|
123
|
+
return { name: 'Gunicorn', category: 'api-server', confidence: 'high' };
|
|
124
|
+
}
|
|
125
|
+
// 3. Check Ruby / Rails
|
|
126
|
+
if (cmd.includes('rails s') || cmd.includes('puma') || cmd.includes('bin/rails')) {
|
|
127
|
+
return { name: 'Ruby on Rails (Puma)', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
128
|
+
}
|
|
129
|
+
// 4. Check Go / Rust / Java
|
|
130
|
+
if (cmd.includes('go run') || procName.endsWith('_go')) {
|
|
131
|
+
return { name: 'Go HTTP Server', category: 'api-server', confidence: 'medium' };
|
|
132
|
+
}
|
|
133
|
+
if (cmd.includes('cargo run') || procName.includes('target/debug')) {
|
|
134
|
+
return { name: 'Rust App', category: 'api-server', confidence: 'medium' };
|
|
135
|
+
}
|
|
136
|
+
if (procName.includes('java') || cmd.includes('spring-boot') || cmd.includes('gradle') || cmd.includes('mvn')) {
|
|
137
|
+
return { name: 'Spring Boot / Java', category: 'web-framework', confidence: 'medium', defaultPort: 8080 };
|
|
138
|
+
}
|
|
139
|
+
// 5. Inspect package.json dependencies if available
|
|
140
|
+
if (projectContext?.packageJsonPath) {
|
|
141
|
+
try {
|
|
142
|
+
const content = await fs.readFile(projectContext.packageJsonPath, 'utf8');
|
|
143
|
+
const pkg = JSON.parse(content);
|
|
144
|
+
const allDeps = {
|
|
145
|
+
...pkg.dependencies,
|
|
146
|
+
...pkg.devDependencies,
|
|
147
|
+
};
|
|
148
|
+
if (allDeps['next']) {
|
|
149
|
+
return { name: 'Next.js', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
150
|
+
}
|
|
151
|
+
if (allDeps['vite']) {
|
|
152
|
+
return { name: 'Vite', category: 'web-framework', confidence: 'high', defaultPort: 5173 };
|
|
153
|
+
}
|
|
154
|
+
if (allDeps['astro']) {
|
|
155
|
+
return { name: 'Astro', category: 'web-framework', confidence: 'high', defaultPort: 4321 };
|
|
156
|
+
}
|
|
157
|
+
if (allDeps['remix'] || allDeps['@remix-run/dev']) {
|
|
158
|
+
return { name: 'Remix', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
159
|
+
}
|
|
160
|
+
if (allDeps['nuxt']) {
|
|
161
|
+
return { name: 'Nuxt', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
162
|
+
}
|
|
163
|
+
if (allDeps['svelte'] || allDeps['@sveltejs/kit']) {
|
|
164
|
+
return { name: 'SvelteKit', category: 'web-framework', confidence: 'high', defaultPort: 5173 };
|
|
165
|
+
}
|
|
166
|
+
if (allDeps['@nestjs/core']) {
|
|
167
|
+
return { name: 'NestJS', category: 'api-server', confidence: 'high', defaultPort: 3000 };
|
|
168
|
+
}
|
|
169
|
+
if (allDeps['express']) {
|
|
170
|
+
return { name: 'Express', category: 'api-server', confidence: 'high' };
|
|
171
|
+
}
|
|
172
|
+
if (allDeps['fastify']) {
|
|
173
|
+
return { name: 'Fastify', category: 'api-server', confidence: 'high' };
|
|
174
|
+
}
|
|
175
|
+
if (allDeps['koa']) {
|
|
176
|
+
return { name: 'Koa', category: 'api-server', confidence: 'high' };
|
|
177
|
+
}
|
|
178
|
+
if (allDeps['hono']) {
|
|
179
|
+
return { name: 'Hono', category: 'api-server', confidence: 'high' };
|
|
180
|
+
}
|
|
181
|
+
if (allDeps['react-scripts']) {
|
|
182
|
+
return { name: 'Create React App', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
catch {
|
|
186
|
+
// ignore
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
// 6. Direct command inspection for JS frameworks
|
|
190
|
+
if (cmd.includes('next dev') || cmd.includes('next start')) {
|
|
191
|
+
return { name: 'Next.js', category: 'web-framework', confidence: 'high', defaultPort: 3000 };
|
|
192
|
+
}
|
|
193
|
+
if (cmd.includes('vite')) {
|
|
194
|
+
return { name: 'Vite', category: 'web-framework', confidence: 'high', defaultPort: 5173 };
|
|
195
|
+
}
|
|
196
|
+
if (cmd.includes('astro dev')) {
|
|
197
|
+
return { name: 'Astro', category: 'web-framework', confidence: 'high', defaultPort: 4321 };
|
|
198
|
+
}
|
|
199
|
+
if (cmd.includes('nodemon') || cmd.includes('ts-node') || cmd.includes('tsx') || cmd.includes('node ')) {
|
|
200
|
+
return { name: 'Node.js Server', category: 'runtime', confidence: 'medium' };
|
|
201
|
+
}
|
|
202
|
+
if (procName === 'node' || procName === 'bun' || procName === 'deno') {
|
|
203
|
+
return {
|
|
204
|
+
name: procName.charAt(0).toUpperCase() + procName.slice(1),
|
|
205
|
+
category: 'runtime',
|
|
206
|
+
confidence: 'low',
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
return undefined;
|
|
210
|
+
}
|
|
211
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/framework/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGvC,MAAM,UAAU,eAAe,CAAC,WAAyB;IACvD,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEjF,kFAAkF;IAClF,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAC1G,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAC1E,CAAC;IACF,IAAI,YAAY;QAAE,OAAO,KAAK,CAAC;IAE/B,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACvH,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IAE7B,mCAAmC;IACnC,IACE,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAClC,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QACvC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAC/B,GAAG,CAAC,UAAU,CAAC,2BAA2B,CAAC;QAC3C,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAClC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,IACE,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACrC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACrC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EACrC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,IACE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;QACnC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAC/B,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,EACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,aAAa,GAAG;QACpB,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;QACrE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB;QAC7E,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa;KACtE,CAAC;IAEF,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAgB;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE/C,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACzG,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1E,OAAO,+BAA+B,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,IAAI,gBAAgB,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAyB,EACzB,cAA+B,EAC/B,IAAa;IAEb,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,WAAW,IAAI,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACnF,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEzD,kCAAkC;IAClC,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,uBAAuB,CAAC,WAAW,EAAE,IAAI,IAAI,gBAAgB,EAAE,WAAW,EAAE,cAAc,CAAC;YACjG,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACnE,CAAC;IAED,iCAAiC;IACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC1E,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5G,CAAC;IAED,4BAA4B;IAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAClF,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9G,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5G,CAAC;IAED,oDAAoD;IACpD,IAAI,cAAc,EAAE,eAAe,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG;gBACd,GAAG,GAAG,CAAC,YAAY;gBACnB,GAAG,GAAG,CAAC,eAAe;aACvB,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC/F,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC5F,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC7F,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC7F,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC5F,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACjG,CAAC;YACD,IAAI,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC3F,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACzE,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACzE,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACrE,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACtE,CAAC;YACD,IAAI,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACxG,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvG,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/E,CAAC;IAED,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACrE,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/git/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,wBAAsB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqD9E"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import * as path from 'node:path';
|
|
2
|
+
import * as fs from 'node:fs/promises';
|
|
3
|
+
import { safeExecFile } from '../../utils/exec.js';
|
|
4
|
+
export async function detectGitContext(directory) {
|
|
5
|
+
const notGit = { isGitRepo: false };
|
|
6
|
+
if (!directory)
|
|
7
|
+
return notGit;
|
|
8
|
+
try {
|
|
9
|
+
// Check if .git exists in directory or parent directories
|
|
10
|
+
let currentDir = path.resolve(directory);
|
|
11
|
+
let foundGitDir = false;
|
|
12
|
+
// Fast check: look for .git folder up to 5 levels
|
|
13
|
+
for (let i = 0; i < 5; i++) {
|
|
14
|
+
try {
|
|
15
|
+
const gitPath = path.join(currentDir, '.git');
|
|
16
|
+
const st = await fs.stat(gitPath);
|
|
17
|
+
if (st.isDirectory() || st.isFile()) {
|
|
18
|
+
foundGitDir = true;
|
|
19
|
+
break;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
catch {
|
|
23
|
+
// continue walking up
|
|
24
|
+
}
|
|
25
|
+
const parent = path.dirname(currentDir);
|
|
26
|
+
if (parent === currentDir)
|
|
27
|
+
break;
|
|
28
|
+
currentDir = parent;
|
|
29
|
+
}
|
|
30
|
+
if (!foundGitDir)
|
|
31
|
+
return notGit;
|
|
32
|
+
// Run git commands in the detected directory
|
|
33
|
+
const branchRes = await safeExecFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: currentDir, timeout: 2000 });
|
|
34
|
+
const repoRes = await safeExecFile('git', ['rev-parse', '--show-toplevel'], { cwd: currentDir, timeout: 2000 });
|
|
35
|
+
const statusRes = await safeExecFile('git', ['status', '--porcelain'], { cwd: currentDir, timeout: 2000 });
|
|
36
|
+
const isRepo = branchRes.exitCode === 0 && repoRes.exitCode === 0;
|
|
37
|
+
if (!isRepo)
|
|
38
|
+
return notGit;
|
|
39
|
+
const topLevel = repoRes.stdout.trim();
|
|
40
|
+
const repoName = path.basename(topLevel);
|
|
41
|
+
const branch = branchRes.stdout.trim();
|
|
42
|
+
const changedLines = statusRes.stdout.split('\n').filter((l) => l.trim().length > 0);
|
|
43
|
+
const isDirty = changedLines.length > 0;
|
|
44
|
+
return {
|
|
45
|
+
isGitRepo: true,
|
|
46
|
+
repoName,
|
|
47
|
+
branch: branch === 'HEAD' ? 'detached HEAD' : branch,
|
|
48
|
+
isDirty,
|
|
49
|
+
uncommittedFilesCount: changedLines.length,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return notGit;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/git/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { FreeResult } from '../../types/index.js';
|
|
2
|
+
export declare function releasePort(port: number, options?: {
|
|
3
|
+
force?: boolean;
|
|
4
|
+
timeoutMs?: number;
|
|
5
|
+
expectedPid?: number;
|
|
6
|
+
onProgress?: (msg: string) => void;
|
|
7
|
+
}): Promise<FreeResult>;
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/lifecycle/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAC;AAO5D,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,GACL,OAAO,CAAC,UAAU,CAAC,CAqLrB"}
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import { getPlatformAdapter } from '../../platform/index.js';
|
|
2
|
+
import { inspectPort } from '../process/index.js';
|
|
3
|
+
function sleep(ms) {
|
|
4
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
5
|
+
}
|
|
6
|
+
export async function releasePort(port, options = {}) {
|
|
7
|
+
const startTime = Date.now();
|
|
8
|
+
const { force = false, timeoutMs = 2500, onProgress } = options;
|
|
9
|
+
const adapter = getPlatformAdapter();
|
|
10
|
+
if (!Number.isInteger(port) || port <= 0 || port > 65535) {
|
|
11
|
+
return {
|
|
12
|
+
port,
|
|
13
|
+
pid: 0,
|
|
14
|
+
processName: 'none',
|
|
15
|
+
success: false,
|
|
16
|
+
method: 'none',
|
|
17
|
+
timeTakenMs: 0,
|
|
18
|
+
error: `Invalid port number: ${port}`,
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
// 1. Inspect target port
|
|
22
|
+
const portInfo = await inspectPort(port, { deep: true });
|
|
23
|
+
if (portInfo.status === 'free' || !portInfo.pid) {
|
|
24
|
+
return {
|
|
25
|
+
port,
|
|
26
|
+
pid: 0,
|
|
27
|
+
processName: 'none',
|
|
28
|
+
success: true,
|
|
29
|
+
method: 'none',
|
|
30
|
+
timeTakenMs: Date.now() - startTime,
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
const pid = options.expectedPid || portInfo.pid;
|
|
34
|
+
const processName = portInfo.process?.name || 'unknown';
|
|
35
|
+
const projectName = portInfo.project?.name;
|
|
36
|
+
// Helper to verify that the port is still owned by the expected PID before killing
|
|
37
|
+
const verifyOwnership = async () => {
|
|
38
|
+
const currentMatches = await adapter.findListeningPorts([port]);
|
|
39
|
+
if (currentMatches.length === 0) {
|
|
40
|
+
return { ok: false, currentPid: undefined }; // Already freed
|
|
41
|
+
}
|
|
42
|
+
const matching = currentMatches.find((m) => m.pid === pid);
|
|
43
|
+
if (!matching) {
|
|
44
|
+
const otherPid = currentMatches[0]?.pid;
|
|
45
|
+
return {
|
|
46
|
+
ok: false,
|
|
47
|
+
currentPid: otherPid,
|
|
48
|
+
error: `Port ${port} ownership changed from PID ${pid} to PID ${otherPid}. Aborted kill to prevent terminating the wrong process.`,
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
return { ok: true, currentPid: pid };
|
|
52
|
+
};
|
|
53
|
+
// Pre-kill race verification
|
|
54
|
+
const preCheck = await verifyOwnership();
|
|
55
|
+
if (!preCheck.ok) {
|
|
56
|
+
if (preCheck.error) {
|
|
57
|
+
return {
|
|
58
|
+
port,
|
|
59
|
+
pid,
|
|
60
|
+
processName,
|
|
61
|
+
projectName,
|
|
62
|
+
success: false,
|
|
63
|
+
method: 'none',
|
|
64
|
+
timeTakenMs: Date.now() - startTime,
|
|
65
|
+
error: preCheck.error,
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
else {
|
|
69
|
+
// Port already released
|
|
70
|
+
return {
|
|
71
|
+
port,
|
|
72
|
+
pid,
|
|
73
|
+
processName,
|
|
74
|
+
projectName,
|
|
75
|
+
success: true,
|
|
76
|
+
method: 'none',
|
|
77
|
+
timeTakenMs: Date.now() - startTime,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
// 2. If force is explicitly requested, go directly to SIGKILL / taskkill /f
|
|
82
|
+
if (force) {
|
|
83
|
+
onProgress?.(`Force terminating PID ${pid} (${processName})...`);
|
|
84
|
+
await adapter.kill(pid, 'SIGKILL');
|
|
85
|
+
await sleep(200);
|
|
86
|
+
const isStillListening = await adapter.isPortListening(port);
|
|
87
|
+
return {
|
|
88
|
+
port,
|
|
89
|
+
pid,
|
|
90
|
+
processName,
|
|
91
|
+
projectName,
|
|
92
|
+
success: !isStillListening,
|
|
93
|
+
method: 'SIGKILL',
|
|
94
|
+
timeTakenMs: Date.now() - startTime,
|
|
95
|
+
error: isStillListening ? 'Process resisted SIGKILL or requires elevated permissions (sudo).' : undefined,
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
// 3. Graceful termination Step 1: SIGINT (Ctrl+C equivalent)
|
|
99
|
+
onProgress?.(`Sending SIGINT (graceful shutdown) to PID ${pid}...`);
|
|
100
|
+
await adapter.kill(pid, 'SIGINT');
|
|
101
|
+
// Poll socket for release
|
|
102
|
+
const maxWaitInt = Math.min(1500, timeoutMs);
|
|
103
|
+
const startInt = Date.now();
|
|
104
|
+
while (Date.now() - startInt < maxWaitInt) {
|
|
105
|
+
await sleep(100);
|
|
106
|
+
const stillBusy = await adapter.isPortListening(port);
|
|
107
|
+
if (!stillBusy) {
|
|
108
|
+
return {
|
|
109
|
+
port,
|
|
110
|
+
pid,
|
|
111
|
+
processName,
|
|
112
|
+
projectName,
|
|
113
|
+
success: true,
|
|
114
|
+
method: 'SIGINT',
|
|
115
|
+
timeTakenMs: Date.now() - startTime,
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
// 4. Graceful termination Step 2: SIGTERM
|
|
120
|
+
// Verify ownership before SIGTERM
|
|
121
|
+
const termCheck = await verifyOwnership();
|
|
122
|
+
if (!termCheck.ok) {
|
|
123
|
+
if (termCheck.error) {
|
|
124
|
+
return {
|
|
125
|
+
port,
|
|
126
|
+
pid,
|
|
127
|
+
processName,
|
|
128
|
+
projectName,
|
|
129
|
+
success: false,
|
|
130
|
+
method: 'none',
|
|
131
|
+
timeTakenMs: Date.now() - startTime,
|
|
132
|
+
error: termCheck.error,
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
return {
|
|
136
|
+
port,
|
|
137
|
+
pid,
|
|
138
|
+
processName,
|
|
139
|
+
projectName,
|
|
140
|
+
success: true,
|
|
141
|
+
method: 'SIGINT',
|
|
142
|
+
timeTakenMs: Date.now() - startTime,
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
onProgress?.(`Process still listening. Sending SIGTERM to PID ${pid}...`);
|
|
146
|
+
await adapter.kill(pid, 'SIGTERM');
|
|
147
|
+
const startTerm = Date.now();
|
|
148
|
+
while (Date.now() - startTerm < 1000) {
|
|
149
|
+
await sleep(100);
|
|
150
|
+
const stillBusy = await adapter.isPortListening(port);
|
|
151
|
+
if (!stillBusy) {
|
|
152
|
+
return {
|
|
153
|
+
port,
|
|
154
|
+
pid,
|
|
155
|
+
processName,
|
|
156
|
+
projectName,
|
|
157
|
+
success: true,
|
|
158
|
+
method: 'SIGTERM',
|
|
159
|
+
timeTakenMs: Date.now() - startTime,
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
// 5. Graceful termination failed
|
|
164
|
+
return {
|
|
165
|
+
port,
|
|
166
|
+
pid,
|
|
167
|
+
processName,
|
|
168
|
+
projectName,
|
|
169
|
+
success: false,
|
|
170
|
+
method: 'SIGTERM',
|
|
171
|
+
timeTakenMs: Date.now() - startTime,
|
|
172
|
+
error: `Process PID ${pid} did not terminate gracefully within timeout. Use 'port-doctor free ${port} --force' to force-kill.`,
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/lifecycle/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { RawPortMatch } from '../../platform/index.js';
|
|
2
|
+
import { PortInfo } from '../../types/index.js';
|
|
3
|
+
export declare function inspectPort(port: number, options?: {
|
|
4
|
+
deep?: boolean;
|
|
5
|
+
}): Promise<PortInfo>;
|
|
6
|
+
export declare function enrichPortMatch(match: RawPortMatch, options?: {
|
|
7
|
+
deep?: boolean;
|
|
8
|
+
}): Promise<PortInfo>;
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAe,MAAM,sBAAsB,CAAC;AAO7D,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwB/G;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAmB,GAC3C,OAAO,CAAC,QAAQ,CAAC,CAuEnB"}
|