ErrorHelper.tsā¢4.46 kB
export class ErrorHelper {
public static createErrorWithGuidance(message: string, guidance: string): string {
return `${message}\n\nš” To fix this:\n${guidance}`;
}
public static getXcodeNotFoundGuidance(): string {
return [
"ā¢ Install Xcode from the Mac App Store",
"ā¢ Make sure Xcode is in your /Applications folder",
"ā¢ Launch Xcode once to complete the installation",
"ā¢ Accept the license agreement when prompted"
].join('\n');
}
public static getProjectNotFoundGuidance(projectPath: string): string {
return [
`ā¢ Check that the path is correct: ${projectPath}`,
"ā¢ Use an absolute path (starting with /)",
"ā¢ Make sure the file extension is .xcodeproj or .xcworkspace",
"ā¢ Verify the project file hasn't been moved or deleted"
].join('\n');
}
public static getSchemeNotFoundGuidance(schemeName: string, availableSchemes: string[] = []): string {
const guidance = [
`ā¢ Check the scheme name spelling: '${schemeName}'`,
"ā¢ Scheme names are case-sensitive"
];
if (availableSchemes.length > 0) {
guidance.push("ā¢ Available schemes:");
availableSchemes.forEach(scheme => {
guidance.push(` - ${scheme}`);
});
} else {
guidance.push("ā¢ Run 'Get Schemes' to see available schemes");
}
return guidance.join('\n');
}
public static getDestinationNotFoundGuidance(destination: string, availableDestinations: string[] = []): string {
const guidance = [
`ā¢ Check the destination name spelling: '${destination}'`,
"ā¢ Destination names are case-sensitive"
];
if (availableDestinations.length > 0) {
guidance.push("ā¢ Available destinations:");
availableDestinations.forEach(dest => {
guidance.push(` - ${dest}`);
});
} else {
guidance.push("ā¢ Run 'Get Run Destinations' to see available destinations");
}
return guidance.join('\n');
}
public static getXcodeNotRunningGuidance(): string {
return [
"ā¢ Launch Xcode application",
"ā¢ Make sure Xcode is not stuck on a license agreement",
"ā¢ Try restarting Xcode if it's already open",
"ā¢ Check Activity Monitor for any hanging Xcode processes"
].join('\n');
}
public static getNoWorkspaceGuidance(): string {
return [
"ā¢ Open a project in Xcode first",
"ā¢ Make sure the project has finished loading",
"ā¢ Try closing and reopening the project if it's already open",
"ā¢ Check that the project file is not corrupted"
].join('\n');
}
public static getBuildLogNotFoundGuidance(): string {
return [
"ā¢ Try building the project again",
"ā¢ Check that Xcode has permission to write to derived data",
"ā¢ Clear derived data (Product ā Clean Build Folder) and rebuild",
"ā¢ Ensure XCLogParser is installed: brew install xclogparser"
].join('\n');
}
public static getJXAPermissionGuidance(): string {
return [
"ā¢ Go to System Preferences ā Privacy & Security ā Automation",
"ā¢ Allow your terminal app to control Xcode",
"ā¢ You may need to restart your terminal after granting permission",
"ā¢ If using VS Code, allow 'Code' to control Xcode"
].join('\n');
}
public static parseCommonErrors(error: Error | { message?: string }): string | null {
const errorMessage = error.message || error.toString();
if (errorMessage.includes('Xcode got an error: Application isn\'t running')) {
return this.createErrorWithGuidance(
"Xcode is not running",
this.getXcodeNotRunningGuidance()
);
}
if (errorMessage.includes('No active workspace')) {
return this.createErrorWithGuidance(
"No active workspace found in Xcode",
this.getNoWorkspaceGuidance()
);
}
if (errorMessage.includes('not allowed assistive access')) {
return this.createErrorWithGuidance(
"Permission denied - automation access required",
this.getJXAPermissionGuidance()
);
}
if (errorMessage.includes('osascript: command not found')) {
return this.createErrorWithGuidance(
"macOS scripting tools not available",
"ā¢ This MCP server requires macOS\nā¢ Make sure you're running on a Mac with osascript available"
);
}
return null;
}
}